Руководство разработчика
Ресурсы API

Отзывы о модели

Краткое содержание

Описание

model/{model_id}/opinion

Возвращает отзывы пользователей о модели. Ресурс является списочным.

В запросе вместо {model_id} указывается идентификатор модели.

URL ресурса:

https://api.content.market.yandex.ru/v1/model/{model_id}/opinion.[format]

Входные данные

ПараметрТипЗначение
Необязательные

count

Число

Количество выводимых результатов на странице ответа.

Значение по умолчанию: 10.

Максимально возможное значение: 30.

grade Число

Фильтрация отзывов по оценке пользователями модели.

Возможные значения:

  • 2;

  • 1;

  • 0;

  • -1;

  • -2.

how Строка

Направление сортировки.

Возможные значения:

  • desc — сортировка по убыванию;

  • asc — сортировка по возрастанию.

Значение по умолчанию: desc.

max_comments

Число

Количество комментариев в выходных данных.

Значение по умолчанию: 0.

page

Число

Номер страницы результатов, которую необходимо показать в ответе.

Значение по умолчанию: 1.

Максимально возможное значение: 50.

sort Строка

Тип сортировки отзывов.

Возможные значения:

  • grade — сортировка по оценке пользователем модели;

  • date — сортировка по дате написания отзыва;

  • rank — сортировка по полезности отзыва.

Значение по умолчанию: date.

Выходные данные

Структура выходных данных:

<opinion-list
[no-highlight[

Значение

Список отзывов о модели.

]no-highlight]
count
[no-highlight[

Значение

Количество выводимых результатов на странице.

Для формата XML является атрибутом.

]no-highlight]
="{количество_результатов_на_странице}" total
[no-highlight[

Значение

Общее количество результатов в списке.

Для формата XML является атрибутом.

]no-highlight]
="{количество_результатов}" page
[no-highlight[

Значение

Номер выводимой страницы результатов.

Для формата XML является атрибутом.

]no-highlight]
="{номер_страницы}"> <opinion
[no-highlight[

Значение

Описание отзыва / отзывов.

]no-highlight]
grade
[no-highlight[

Значение

Оценка пользователя.

Возможные значения:

  • -2;

  • -1;

  • 0;

  • 1;

  • 2.

Для формата XML является атрибутом параметра opinion.

]no-highlight]
="{оценка}" agree
[no-highlight[

Значение

Количество пользователей, положительно оценивших отзыв.

Для формата XML является атрибутом параметра opinion.

]no-highlight]
="{количество_согласных_с_оценкой}" reject
[no-highlight[

Значение

Количество пользователей, отрицательно оценивших отзыв.

Для формата XML является атрибутом параметра opinion.

]no-highlight]
="{количество_не_согласных_с_оценкой}" id
[no-highlight[

Значение

Идентификатор отзыва.

Для формата XML является атрибутом параметра opinion.

]no-highlight]
="{идентификатор_отзыва}"> <anonymous
[no-highlight[

Значение

Признак анонимности отзыва.

Возможные значения:

  • false — не анонимный отзыв;

  • true — анонимный отзыв.

]no-highlight]
>{признак_анонимности_отзыва}</anonymous> <author-info
[no-highlight[

Значение

Информация об авторе отзыва.

]no-highlight]
> <grades
[no-highlight[

Значение

Общее количество отзывов автора.

]no-highlight]
>{количество_оценок_автора_отзыва}</grades> <avatar
[no-highlight[

Значение

URL изображения аватара автора отзыва.

]no-highlight]
>{ссылка_на_аватар}</avatar> <social
[no-highlight[

Значение

Информация о профилях автора отзыва в социальных сетях.

]no-highlight]
> <profile
[no-highlight[

Значение

Профиль автора отзыва в социальной сети. Параметр выводится только для формата XML.

]no-highlight]
type
[no-highlight[

Значение

Социальная сеть профиля.

Возможные значения:

  • FACEBOOK — facebook.com;

  • FOURSQUARE — foursquare.com;

  • GOOGLE — google.com;

  • LASTFM — last.fm;

  • MAILRU — mail.ru;

  • ODNOKLASSNIKI — odnoklassniki.ru;

  • TWITTER — twitter.com;

  • VKONTAKTE — vk.com.

Для формата XML является атрибутом параметра profile.

]no-highlight]
="{тип_социальной_сети}">{ссылка_на_профиль}</profile> </social> </author-info> <date
[no-highlight[

Значение

Дата написания отзыва.

]no-highlight]
>{дата_написания}</date> <author
[no-highlight[

Значение

Логин либо имя и фамилия автора отзыва.

]no-highlight]
>{имя_автора_отзыва}</author> <text
[no-highlight[

Значение

Текст отзыва.

]no-highlight]
>{текст}</text> <contra
[no-highlight[

Значение

Недостатки магазина или модели по мнению автора отзыва.

]no-highlight]
>{описание_недостатков}</contra> <pro
[no-highlight[

Значение

Достоинства магазина или модели по мнению автора отзыва.

]no-highlight]
>{описание_достоинств}</pro> <region
[no-highlight[

Значение

Код региона, в котором находится автор отзыва.

]no-highlight]
>{регион}</region> <visibility
[no-highlight[

Значение

Признак видимости имени автора отзыва.

Возможные значения:

  • ANONYMOUS — автор отзыва скрыл свое имя;

  • NAME — автор оставил отзыв от своего имени.

]no-highlight]
>{признак_видимости_имени_автора}</visibility> <usage-time
[no-highlight[

Значение

Опыт использования модели.

Возможные значения:

  • FEW_WEEKS — менее месяца;

  • FEW_MONTHS — несколько месяцев;

  • FEW_YEARS — более года.

]no-highlight]
>{опыт_использования_модели}</usage-time> <price-grade
[no-highlight[

Значение

Адекватность цены модели.

Возможные значения:

  • 2;

  • 1;

  • 0;

  • -1;

  • -2.

]no-highlight]
>{адекватность_цены}</price-grade> <convenience-grade
[no-highlight[

Значение

Удобство эксплуатации модели.

Возможные значения:

  • 2;

  • 1;

  • 0;

  • -1;

  • -2.

]no-highlight]
>{удобство_эксплутации_модели}</convenience-grade> <quality-grade
[no-highlight[

Значение

Качество изготовления модели.

Возможные значения:

  • 2;

  • 1;

  • 0;

  • -1;

  • -2.

]no-highlight]
>{качество_изготовления_модели}</quality-grade> </opinion> ... </opinion-list>
{
  "modelOpinions
[no-highlight[

Значение

Список отзывов о модели.

]no-highlight]
": { "count
[no-highlight[

Значение

Количество выводимых результатов на странице.

Для формата XML является атрибутом.

]no-highlight]
": {количество_результатов_на_странице}, "total
[no-highlight[

Значение

Общее количество результатов в списке.

Для формата XML является атрибутом.

]no-highlight]
": {количество_результатов}, "page
[no-highlight[

Значение

Номер выводимой страницы результатов.

Для формата XML является атрибутом.

]no-highlight]
": {номер_страницы}, "opinion
[no-highlight[

Значение

Описание отзыва / отзывов.

]no-highlight]
": [ { "grade
[no-highlight[

Значение

Оценка пользователя.

Возможные значения:

  • -2;

  • -1;

  • 0;

  • 1;

  • 2.

Для формата XML является атрибутом параметра opinion.

]no-highlight]
": {оценка}, "agree
[no-highlight[

Значение

Количество пользователей, положительно оценивших отзыв.

Для формата XML является атрибутом параметра opinion.

]no-highlight]
": {количество_согласных_с_оценкой}, "reject
[no-highlight[

Значение

Количество пользователей, отрицательно оценивших отзыв.

Для формата XML является атрибутом параметра opinion.

]no-highlight]
": {количество_не_согласных_с_оценкой}, "id
[no-highlight[

Значение

Идентификатор отзыва.

Для формата XML является атрибутом параметра opinion.

]no-highlight]
": {идентификатор_отзыва}, "anonymous
[no-highlight[

Значение

Признак анонимности отзыва.

Возможные значения:

  • false — не анонимный отзыв;

  • true — анонимный отзыв.

]no-highlight]
": {признак_анонимности_отзыва}, "authorInfo
[no-highlight[

Значение

Информация об авторе отзыва.

]no-highlight]
": { "grades
[no-highlight[

Значение

Общее количество отзывов автора.

]no-highlight]
": {количество_отзывов_автора}, "avatarUrl
[no-highlight[

Значение

URL изображения аватара автора отзыва.

]no-highlight]
": {ссылка_на_аватар}, "socialProviders
[no-highlight[

Значение

Информация о профилях автора отзыва в социальных сетях.

]no-highlight]
": [ { "type
[no-highlight[

Значение

Социальная сеть профиля.

Возможные значения:

  • FACEBOOK — facebook.com;

  • FOURSQUARE — foursquare.com;

  • GOOGLE — google.com;

  • LASTFM — last.fm;

  • MAILRU — mail.ru;

  • ODNOKLASSNIKI — odnoklassniki.ru;

  • TWITTER — twitter.com;

  • VKONTAKTE — vk.com.

Для формата XML является атрибутом параметра profile.

]no-highlight]
": "{тип_социальной_сети}", "url
[no-highlight[

Значение

URL профиля автора отзыва. Параметр выводится только для формата JSON.

]no-highlight]
": {ссылка_на_профиль} }, ... ] }, "date
[no-highlight[

Значение

Дата написания отзыва.

]no-highlight]
": {дата_написания}, "author
[no-highlight[

Значение

Логин либо имя и фамилия автора отзыва.

]no-highlight]
": "{имя_автора_отзыва}", "text
[no-highlight[

Значение

Текст отзыва.

]no-highlight]
": "{текст}", "contra
[no-highlight[

Значение

Недостатки магазина или модели по мнению автора отзыва.

]no-highlight]
": "{описание_недостатков}", "pro
[no-highlight[

Значение

Достоинства магазина или модели по мнению автора отзыва.

]no-highlight]
": "{описание_достоинств}", "region
[no-highlight[

Значение

Код региона, в котором находится автор отзыва.

]no-highlight]
": {код_региона}, "visibility
[no-highlight[

Значение

Признак видимости имени автора отзыва.

Возможные значения:

  • ANONYMOUS — автор отзыва скрыл свое имя;

  • NAME — автор оставил отзыв от своего имени.

]no-highlight]
": "{признак_видимости_имени_автора}", "usageTime
[no-highlight[

Значение

Опыт использования модели.

Возможные значения:

  • FEW_WEEKS — менее месяца;

  • FEW_MONTHS — несколько месяцев;

  • FEW_YEARS — более года.

]no-highlight]
": "{опыт_использования_модели}", "priceGrade
[no-highlight[

Значение

Адекватность цены модели.

Возможные значения:

  • 2;

  • 1;

  • 0;

  • -1;

  • -2.

]no-highlight]
": {адекватность_цены}, "convenienceGrade
[no-highlight[

Значение

Удобство эксплуатации модели.

Возможные значения:

  • 2;

  • 1;

  • 0;

  • -1;

  • -2.

]no-highlight]
": {удобство_эксплутации_модели}, "qualityGrade
[no-highlight[

Значение

Качество изготовления модели.

Возможные значения:

  • 2;

  • 1;

  • 0;

  • -1;

  • -2.

]no-highlight]
": {качество_изготовления_модели} }, ... ] } }

Описание параметров:

Параметр для формата XMLПараметр для формата JSONТипЗначение
opinion-list modelOpinions

Список отзывов о модели.

Параметры, вложенные в opinion-list/shopOpinions
count count Число

Количество выводимых результатов на странице.

Для формата XML является атрибутом.

total total Число

Общее количество результатов в списке.

Для формата XML является атрибутом.

page page Число

Номер выводимой страницы результатов.

Для формата XML является атрибутом.

opinion opinion

Описание отзыва / отзывов.

Параметры, вложенные в opinion
grade grade Число

Оценка пользователя.

Возможные значения:

  • -2;

  • -1;

  • 0;

  • 1;

  • 2.

Для формата XML является атрибутом параметра opinion.

agree agree Число

Количество пользователей, положительно оценивших отзыв.

Для формата XML является атрибутом параметра opinion.

reject reject Число

Количество пользователей, отрицательно оценивших отзыв.

Для формата XML является атрибутом параметра opinion.

id id Число

Идентификатор отзыва.

Для формата XML является атрибутом параметра opinion.

anonymous anonymous Логический

Признак анонимности отзыва.

Возможные значения:

  • false — не анонимный отзыв;

  • true — анонимный отзыв.

author-info authorInfo

Информация об авторе отзыва.

date date Дата

Дата написания отзыва.

author author Строка

Логин либо имя и фамилия автора отзыва.

text text Строка

Текст отзыва.

contra contra Строка

Недостатки магазина или модели по мнению автора отзыва.

pro pro Строка

Достоинства магазина или модели по мнению автора отзыва.

region region Число

Код региона, в котором находится автор отзыва.

visibility visibility Строка

Признак видимости имени автора отзыва.

Возможные значения:

  • ANONYMOUS — автор отзыва скрыл свое имя;

  • NAME — автор оставил отзыв от своего имени.

usage-time usageTime Число

Опыт использования модели.

Возможные значения:

  • FEW_WEEKS — менее месяца;

  • FEW_MONTHS — несколько месяцев;

  • FEW_YEARS — более года.

price-grade priceGrade Число

Адекватность цены модели.

Возможные значения:

  • 2;

  • 1;

  • 0;

  • -1;

  • -2.

convenience-grade convenienceGrade Число

Удобство эксплуатации модели.

Возможные значения:

  • 2;

  • 1;

  • 0;

  • -1;

  • -2.

quality-grade qualityGrade Число

Качество изготовления модели.

Возможные значения:

  • 2;

  • 1;

  • 0;

  • -1;

  • -2.

Параметры, вложенные в author-info / authorInfo

grades grades Число

Общее количество отзывов автора.

avatar avatarUrl Строка

URL изображения аватара автора отзыва.

social socialProviders

Информация о профилях автора отзыва в социальных сетях.

Параметры, вложенные в social

profile

Профиль автора отзыва в социальной сети. Параметр выводится только для формата XML.

Параметры, вложенные в profile / socialProviders

type type Строка

Социальная сеть профиля.

Возможные значения:

  • FACEBOOK — facebook.com;

  • FOURSQUARE — foursquare.com;

  • GOOGLE — google.com;

  • LASTFM — last.fm;

  • MAILRU — mail.ru;

  • ODNOKLASSNIKI — odnoklassniki.ru;

  • TWITTER — twitter.com;

  • VKONTAKTE — vk.com.

Для формата XML является атрибутом параметра profile.

url Строка

URL профиля автора отзыва. Параметр выводится только для формата JSON.

Описания ошибок

В случае возникновения ошибочной ситуации сервер возвращает HTTP-статус ответа и сообщение об ошибке. Описание ошибок приведено в разделе Сообщения об ошибках.

Примеры

Пример запроса:

GET https://api.content.market.yandex.ru/v1/model/10498476/opinion.xml?sort=rank&count=1

Пример ответа:

<opinion-list count="1" total="42" page="1">
  <opinion id="44685302" agree="149" reject="4" grade="2">
    <text>
      Хотел брать iPad Air, но как нормальный потребитель, начал сравнивать с конкурентами, конкурентов оказалось немного, среди них и сей гаджет...
    </text>
    <pro>На мой взгляд, включает в себя все лучшее на сегодняшний день...</pro>
    <contra>
      Соотношение батарейки и процессора, при максимальной яркости и производительности разряжается быстрее, чем заряжается - извечная проблема Samsung (но в том есть свой плюс, чем дольше идёт заряд, тем долговечнее батарея)...
    </contra>
    <date>2014-01-27T10:16:07.000+04:00</date>
    <anonymous>false</anonymous>
    <author>VasyA</author>
    <author-info>
      <grades>1</grades>
    </author-info>
    <usage-time>FEW_MONTHS</usage-time>
    <price-grade>1</price-grade>
    <convenience-grade>2</convenience-grade>
    <quality-grade>2</quality-grade>
  </opinion>
</opinion-list>

Пример запроса:

GET https://api.content.market.yandex.ru/v1/model/10498476/opinion.json?sort=rank&count=1

Пример ответа:

{
  "modelOpinions":
  {
    "opinion":
    [
      {
        "id": 44685302,
        "date": 1390803367000,
        "grade": 2,
        "text": "Хотел брать iPad Air, но как нормальный потребитель, начал сравнивать с конкурентами, конкурентов оказалось немного, среди них и сей гаджет...",
        "agree": 149,
        "reject": 4,
        "visibility": "NAME",
        "author": "VasyA",
        "authorInfo":
        {
          "grades": 1
        },
        "pro": "На мой взгляд, включает в себя все лучшее на сегодняшний день...",
        "contra": "Соотношение батарейки и процессора, при максимальной яркости и производительности разряжается быстрее, чем заряжается - извечная проблема Samsung (но в том есть свой плюс, чем дольше идёт заряд, тем долговечнее батарея)...",
        "region": 213,
        "usageTime": "FEW_MONTHS",
        "qualityGrade": 2,
        "priceGrade": 1,
        "convenienceGrade": 2,
        "anonymous": false
      }
    ],
    "total": 42,
    "page": 1,
    "count": 1
  }
}
model/{model_id}/opinion Отзывы