Перейти к содержимому

Сводка рецензий на произведение

GET/v1/works/{id}/reviews/summary

Возвращает количество рецензий и оценок, среднюю оценку, распределение оценок, средние по категориям и плюсы и минусы, которые рецензенты упоминают чаще всего.

Запрос

Shell
curl "https://api.nogitsu.com/v1/works/01a0cb02-0a14-7877-911d-5b4dde76df72/reviews/summary"

Параметры

  • id

    путьобязательный

    Идентификатор элемента, UUID.

    текст

Ответ

Успешный запрос отвечает 200 с таким JSON:

  • reviewCountцелое число

    От 0 до 9007199254740991

  • ratingCountцелое число

    От 0 до 9007199254740991

  • averageHalfPointsчисломожет быть null
  • scoreBucketsсписок из целое число

    От 0 до 9007199254740991

  • categoriesсписок из объект
    • categoryтекст
      Допустимые значенияstorycharactersvisualssoundenjoyment
    • averageHalfPointsчисло
    • scoreCountцелое число

      От 0 до 9007199254740991

  • topPraisedCategoryтекстможет быть null
    Допустимые значенияstorycharactersvisualssoundenjoyment
  • themesсписок из объект
    • kindтекст
      Допустимые значенияprocon
    • labelтекст
    • countцелое число

      От 0 до 9007199254740991

  • languagesсписок из текст

Ошибки

Как и любая операция, эта может ответить 400 при неверных параметрах, 404, если ничего не найдено, и 429, если вы отправляете слишком много запросов. У всех ошибок один формат.

Подробнее об ошибках