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

Отзывы о магазине

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

Описание

shop/{shop_id}/opinion

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

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

URL ресурса:

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

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

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

count

Integer

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

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

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

grade Число

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

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

  • 2;

  • 1;

  • 0;

  • -1;

  • -2.

how

Enum

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

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

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

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

Ограничение. Значение по умолчанию зависит от параметра sort. Если sort=price, значение по умолчанию how=asc. В остальных случаях значение по умолчанию how=desc.

max_comments

Integer

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

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

page

Integer

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

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

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

sort Строка

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

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

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

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

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

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

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

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

Внимание! В выходных данных выводятся служебные параметры, которые не описаны в таблице.
<opinion-list
[no-highlight[

Значение

Список отзывов о магазине.

]no-highlight]
total
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

]no-highlight]
id
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

  • -2;

  • -1;

  • 0;

  • 1;

  • 2.

Для формата 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> <comments
[no-highlight[

Значение

Список комментариев.

Параметр присутствует в выходных данных, если значение параметра max_comments во входных данных > 0.

]no-highlight]
> <comment
[no-highlight[

Значение

Комментарий.

]no-highlight]
id
[no-highlight[

Значение

Идентификатор комментария.

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

]no-highlight]
="{идентификатор_комментария}" root-id
[no-highlight[

Значение

Идентификатор объекта, на который написан комментарий.

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

]no-highlight]
="{идентификатор_объекта}" parent-id
[no-highlight[

Значение

Идентификатор родительского комментария.

Для комментария верхнего уровня значение параметра совпадает со значением root-id.

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

]no-highlight]
="{идентификатор_родительского_комментария}" update-timestamp
[no-highlight[

Значение

Время создания/изменения комментария в системе UNIX-времени.

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

]no-highlight]
="{время_создания/изменения_комментария}" deleted
[no-highlight[

Значение

Признак удаленного комментария.

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

  • 1/true — комментарий удален;

  • 0/false — комментарий не удален.

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

]no-highlight]
="{признак_удаленного_комментария}" blocked
[no-highlight[

Значение

Признак заблокированного комментария.

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

  • 1/true — комментарий заблокирован;

  • 0/false — комментарий не является заблокированным.

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

]no-highlight]
="{признак_заблокированного_комментария}"> <user
[no-highlight[

Значение

Информация о пользователе, оставившем комментарий.

]no-highlight]
id
[no-highlight[

Значение

Идентификатор пользователя, оставившего комментарий.

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

]no-highlight]
="{идентификатор_автора_комментария}" name
[no-highlight[

Значение

Имя пользователя, оставившего комментарий.

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

]no-highlight]
="{имя_автора_комментария}"/> <title
[no-highlight[

Значение

Заголовок комментария.

]no-highlight]
>{заголовок_комментария}<title
[no-highlight[

Значение

Заголовок комментария.

]no-highlight]
/> <body
[no-highlight[

Значение

Текст комментария.

]no-highlight]
>{текст_комментария}</body> <children
[no-highlight[

Значение

Дочерний комментарий (ответ на комментарий).

]no-highlight]
> <comment
[no-highlight[

Значение

Дочерний комментарий (ответ на комментарий).

]no-highlight]
id
[no-highlight[

Значение

Идентификатор комментария.

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

]no-highlight]
="{идентификатор_комментария}" root-id
[no-highlight[

Значение

Идентификатор объекта, на который написан комментарий.

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

]no-highlight]
="{идентификатор_объекта}" parent-id
[no-highlight[

Значение

Идентификатор родительского комментария.

Для комментария верхнего уровня значение параметра совпадает со значением root-id.

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

]no-highlight]
="{идентификатор_родительского_комментария}" update-timestamp
[no-highlight[

Значение

Время создания/изменения комментария в системе UNIX-времени.

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

]no-highlight]
="{время_создания/изменения_комментария}" deleted
[no-highlight[

Значение

Признак удаленного комментария.

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

  • 1/true — комментарий удален;

  • 0/false — комментарий не удален.

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

]no-highlight]
="{признак_удаленного_комментария}" blocked
[no-highlight[

Значение

Признак заблокированного комментария.

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

  • 1/true — комментарий заблокирован;

  • 0/false — комментарий не является заблокированным.

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

]no-highlight]
="{признак_заблокированного_комментария}"> <user
[no-highlight[

Значение

Информация о пользователе, оставившем комментарий.

]no-highlight]
id
[no-highlight[

Значение

Идентификатор пользователя, оставившего комментарий.

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

]no-highlight]
="{идентификатор_автора_комментария}" name
[no-highlight[

Значение

Имя пользователя, оставившего комментарий.

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

]no-highlight]
="{имя_автора_комментария}"/> <title
[no-highlight[

Значение

Заголовок комментария.

]no-highlight]
>{заголовок_комментария}<title
[no-highlight[

Значение

Заголовок комментария.

]no-highlight]
/> <body
[no-highlight[

Значение

Текст комментария.

]no-highlight]
>{текст_комментария}</body> <children
[no-highlight[

Значение

Дочерний комментарий (ответ на комментарий).

]no-highlight]
/> ... </comment> </children> ... </comment> ... </comments> <region
[no-highlight[

Значение

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

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

Значение

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

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

Значение

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

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

Значение

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

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

Значение

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

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

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

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

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

Значение

Статус решения проблемы пользователя.

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

  • RESOLVED — проблема решена;

  • UNRESOLVED — проблема не решена.

]no-highlight]
>{статус_решения_проблемы}</problem> <contra
[no-highlight[

Значение

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

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

Значение

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

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

Значение

Номер заказа, относящегося к отзыву.

]no-highlight]
>{номер_заказа}</shop-order-id> <delivery
[no-highlight[

Значение

Способ покупки товара, выбранный автором отзыва.

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

  • DELIVERY — доставка;

  • INSTORE — покупка в магазине;

  • PICKUP — самовывоз.

]no-highlight]
>{способ_покупки}</delivery> </opinion> ... </opinion-list>
{
  "shopOpinions
[no-highlight[

Значение

Список отзывов о магазине.

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

  • -2;

  • -1;

  • 0;

  • 1;

  • 2.

Для формата 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]
": {ссылка_на_профиль} }, ... ] }, "comments
[no-highlight[

Значение

Список комментариев.

Параметр присутствует в выходных данных, если значение параметра max_comments во входных данных > 0.

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

Значение

Идентификатор комментария.

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

]no-highlight]
": "{идентификатор_комментария}", "rootId
[no-highlight[

Значение

Идентификатор объекта, на который написан комментарий.

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

]no-highlight]
": "{идентификатор_объекта}", "parentId
[no-highlight[

Значение

Идентификатор родительского комментария.

Для комментария верхнего уровня значение параметра совпадает со значением root-id.

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

]no-highlight]
": "{идентификатор_родительского_комментария}", "updateTimestamp
[no-highlight[

Значение

Время создания/изменения комментария в системе UNIX-времени.

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

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

Значение

Признак удаленного комментария.

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

  • 1/true — комментарий удален;

  • 0/false — комментарий не удален.

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

]no-highlight]
": {признак_удаленного_комментария}, "blocked
[no-highlight[

Значение

Признак заблокированного комментария.

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

  • 1/true — комментарий заблокирован;

  • 0/false — комментарий не является заблокированным.

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

]no-highlight]
": {признак_заблокированного_комментария}, "user
[no-highlight[

Значение

Информация о пользователе, оставившем комментарий.

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

Значение

Идентификатор пользователя, оставившего комментарий.

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

]no-highlight]
": {идентификатор_автора_комментария}, "name
[no-highlight[

Значение

Имя пользователя, оставившего комментарий.

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

]no-highlight]
": "{имя_автора_комментария}" }, "title
[no-highlight[

Значение

Заголовок комментария.

]no-highlight]
": "{заголовок_комментария}", "body
[no-highlight[

Значение

Текст комментария.

]no-highlight]
": "{текст_комментария}", "children
[no-highlight[

Значение

Дочерний комментарий (ответ на комментарий).

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

Значение

Идентификатор дочернего комментария.

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

]no-highlight]
": "{идентификатор_комментария}", "rootId
[no-highlight[

Значение

Идентификатор объекта, на который написан дочерний комментарий.

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

]no-highlight]
": "{идентификатор_объекта}", "parentId
[no-highlight[

Значение

Идентификатор родительского комментария.

Для комментария верхнего уровня значение параметра совпадает со значением root-id.

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

]no-highlight]
": "{идентификатор_родительского_комментария}", "updateTimestamp
[no-highlight[

Значение

Время создания/изменения комментария в системе UNIX-времени.

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

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

Значение

Признак удаленного комментария.

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

  • 1/true — комментарий удален;

  • 0/false — комментарий не удален.

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

]no-highlight]
": {признак_удаленного_комментария}, "blocked
[no-highlight[

Значение

Признак заблокированного комментария.

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

  • 1/true — комментарий заблокирован;

  • 0/false — комментарий не является заблокированным.

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

]no-highlight]
": {признак_заблокированного_комментария}, "user
[no-highlight[

Значение

Информация о пользователе, оставившем комментарий.

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

Значение

Идентификатор пользователя, оставившего комментарий.

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

]no-highlight]
": {идентификатор_автора_комментария}, "name
[no-highlight[

Значение

Имя пользователя, оставившего комментарий.

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

]no-highlight]
": "{имя_автора_комментария}" }, "title
[no-highlight[

Значение

Заголовок комментария.

]no-highlight]
": "{заголовок_комментария}", "body
[no-highlight[

Значение

Текст комментария.

]no-highlight]
": "{текст_комментария}", "children
[no-highlight[

Значение

Дочерний комментарий (ответ на комментарий).

]no-highlight]
": [] } ] }, ... ], "region
[no-highlight[

Значение

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

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

Значение

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

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

Значение

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

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

Значение

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

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

Значение

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

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

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

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

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

Значение

Статус решения проблемы пользователя.

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

  • RESOLVED — проблема решена;

  • UNRESOLVED — проблема не решена.

]no-highlight]
": "{статус_решения_проблемы}", "contra
[no-highlight[

Значение

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

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

Значение

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

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

Значение

Номер заказа, относящегося к отзыву.

]no-highlight]
": "{номер_заказа}", "delivery
[no-highlight[

Значение

Способ покупки товара, выбранный автором отзыва.

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

  • DELIVERY — доставка;

  • INSTORE — покупка в магазине;

  • PICKUP — самовывоз.

]no-highlight]
": "{способ_покупки}" }, ... ] } }

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

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

Список отзывов о магазине.

Параметры, вложенные в opinion-list/shopOpinions
total total Integer

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

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

count count Integer

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

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

page page Integer

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

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

opinion opinion

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

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

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

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

agree agree Integer

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

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

reject reject Integer

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

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

grade grade Integer

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

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

  • -2;

  • -1;

  • 0;

  • 1;

  • 2.

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

anonymous anonymous Boolean

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

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

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

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

author-info authorInfo

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

comments comments

Список комментариев.

Параметр присутствует в выходных данных, если значение параметра max_comments во входных данных > 0.

region region Integer

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

author author String

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

pro pro String

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

text text String

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

visibility visibility Enum

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

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

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

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

problem problem Строка

Статус решения проблемы пользователя.

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

  • RESOLVED — проблема решена;

  • UNRESOLVED — проблема не решена.

contra contra String

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

date date Date

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

shop-order-id shopOrderId String

Номер заказа, относящегося к отзыву.

delivery delivery Enum

Способ покупки товара, выбранный автором отзыва.

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

  • DELIVERY — доставка;

  • INSTORE — покупка в магазине;

  • PICKUP — самовывоз.

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

grades grades String

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

avatar avatarUrl String

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

social socialProviders

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

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

profile

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

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

type type Enum

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

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

  • 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 String

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

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

Комментарий.

Параметры, вложенные в comment/comments
id id Строка

Идентификатор комментария.

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

root-id rootId Строка

Идентификатор объекта, на который написан комментарий.

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

parent-id parentId Строка

Идентификатор родительского комментария.

Для комментария верхнего уровня значение параметра совпадает со значением root-id.

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

update-timestamp updateTimestamp Число

Время создания/изменения комментария в системе UNIX-времени.

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

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

Признак удаленного комментария.

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

  • 1/true — комментарий удален;

  • 0/false — комментарий не удален.

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

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

Признак заблокированного комментария.

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

  • 1/true — комментарий заблокирован;

  • 0/false — комментарий не является заблокированным.

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

user user

Информация о пользователе, оставившем комментарий.

title title Строка

Заголовок комментария.

body body Строка

Текст комментария.

children children

Дочерний комментарий (ответ на комментарий).

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

Идентификатор пользователя, оставившего комментарий.

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

name name Строка

Имя пользователя, оставившего комментарий.

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

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

Дочерний комментарий (ответ на комментарий).

Параметры, вложенные в comment/ children
id id Строка

Идентификатор дочернего комментария.

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

root-id rootId Строка

Идентификатор объекта, на который написан дочерний комментарий.

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

parent-id parentId Строка

Идентификатор родительского комментария.

Для комментария верхнего уровня значение параметра совпадает со значением root-id.

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

update-timestamp updateTimestamp Число

Время создания/изменения комментария в системе UNIX-времени.

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

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

Признак удаленного комментария.

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

  • 1/true — комментарий удален;

  • 0/false — комментарий не удален.

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

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

Признак заблокированного комментария.

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

  • 1/true — комментарий заблокирован;

  • 0/false — комментарий не является заблокированным.

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

user user

Информация о пользователе, оставившем комментарий.

title title Строка

Заголовок комментария.

body body Строка

Текст комментария.

children children

Дочерний комментарий (ответ на комментарий).

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

Идентификатор пользователя, оставившего комментарий.

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

name name Строка

Имя пользователя, оставившего комментарий.

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

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

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

Примеры

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

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

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

<opinion-list total="216" count="1" page="1">
  <opinion id="45952857" agree="1" reject="0" grade="2">
    <anonymous>false</anonymous>
    <author-info>
      <grades>1</grades>
    </author-info>
    <region>213</region>
    <author>Дмитрий</author>
    <pro>Отличный магазин</pro>
    <text>Заказал через сайт...</text>
    <visibility>NAME</visibility>
    <contra>Нет</contra>
    <date>2014-03-10T13:26:41.000+04:00</date>
    <delivery>DELIVERY</delivery>
  </opinion>
</opinion-list>

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

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

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

{
  "shopOpinions":
  {
    "opinion":
    [
      {
        "id": 45952857,
        "date": 1394443601000,
        "grade": 2,
        "text": "Заказал через сайт...",
        "agree": 1,
        "reject": 0,
        "visibility": "NAME",
        "author": "Дмитрий",
        "authorInfo":
        {
          "grades": 1
        },
        "pro": "Отличный магазин",
        "contra": "Нет",
        "region": 213,
        "delivery": "DELIVERY",
        "anonymous": false
      }
    ],
    "total": 216,
    "page": 1,
    "count": 1
  }
}
shop/{shop_id}/opinion Отзывы