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

Список обзоров на модель

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

Описание

model/{model_id}/reviews

Возвращает список обзоров на указанную модель.

Ресурс является списочным.

URL ресурса:

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

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

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

page

Integer

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

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

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

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

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

<reviews
[no-highlight[

Значение

Список обзоров на модель.

]no-highlight]
count
[no-highlight[

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

Обзор/обзоры на модель.

]no-highlight]
url
[no-highlight[

Значение

URL обзора на модель.

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

]no-highlight]
="{URL_обзора}" title
[no-highlight[

Значение

Заголовок обзора на модель.

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

]no-highlight]
="{заголовок_обзора}" fav-icon
[no-highlight[

Значение

URL значка веб-сайта с обзором на модель.

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

]no-highlight]
="{URL_значка_веб-сайта}"/> ... </reviews>
{
  "modelReviews
[no-highlight[

Значение

Список обзоров на модель.

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

Значение

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

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

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

Значение

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

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

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

Значение

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

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

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

Значение

Обзор/обзоры на модель.

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

Значение

URL обзора на модель.

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

]no-highlight]
": {URL_обзора}, "title
[no-highlight[

Значение

Заголовок обзора на модель.

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

]no-highlight]
": "{заголовок_обзора}", "favIcon
[no-highlight[

Значение

URL значка веб-сайта с обзором на модель.

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

]no-highlight]
": {URL_значка_веб-сайта} }, ... ] } }

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

Параметр для формата XMLПараметр для формата JSONТипЗначение
reviews modelReviews

Список обзоров на модель.

Параметры, вложенные в reviews/modelReviews
count count Integer

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

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

total total Integer

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

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

page page Integer

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

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

review reviews

Обзор/обзоры на модель.

Параметры, вложенные в review/reviews
url url Строка

URL обзора на модель.

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

title title Строка

Заголовок обзора на модель.

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

fav-icon favIcon Строка

URL значка веб-сайта с обзором на модель.

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

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

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

Примеры

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

GET https://api.content.market.yandex.ru/v1/model/7348501/reviews.xml

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

<reviews total="2" count="2" page="1">
  <review url="http://www.example.com/irobot-roomba-780.html" title="Робот-пылесос iRobot Roomba 780" fav-icon="http://favicon.yandex.ru/example.com"/>
  <review url="http://www.irobot.ru/page_1.html" title="Фотообзор iRobot Roomba 780" fav-icon="http://favicon.yandex.ru/example_1.com"/>
</reviews>

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

GET https://api.content.market.yandex.ru/v1/model/7348501/reviews.json

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

{
  "modelReviews":
  {
    "reviews":
    [
      {
        "url": "http://www.example.com/irobot-roomba-780.html",
        "title": "Робот-пылесос iRobot Roomba 780",
        "favIcon": "http://favicon.yandex.ru/example.com"
      },
      {
        "url": "http://www.irobot.ru/page_1.html",
        "title": "Фотообзор iRobot Roomba 780",
        "favIcon": "http://favicon.yandex.ru/example_1.com"
      }
    ],
    "total": 2,
    "page": 1,
    "count": 2
  }
}
model/{model-id}/reviews Модели Обзоры Обзоры на модель