reviews

Получить один отзыв по идентификатору

Один отзыв целиком — по идентификатору из списка.

Отзыв должен принадлежать вашему объекту; чужой и несуществующий отвечают одинаково 404, чтобы по ответу нельзя было проверять существование чужих записей.

get/v3/reviews/{review_id}

Request

Base URL: https://api.rewio.ru
URL: https://api.rewio.ru/v3/reviews/{review_id}
Auth: API key in header X-API-Key

Path parameters

review_idinteger required

Encoded review ID

Response

Successful Response

idinteger required

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

link_idinteger required

Идентификатор ссылки (страницы объекта на площадке).

source_idinteger required

Идентификатор площадки, с которой собран отзыв.

source_slugstring nullable

Слаг площадки, с которой собран отзыв (2gis, google, yandex_maps). Отвечать можно, если он совпадает с provider отзыва.

authorstring nullable

Имя автора; null, если анонимен.

textstring nullable

Текст отзыва; null, если отзыв без текста.

review_datestring date-time nullable

Дата и время публикации отзыва. Приводится к UTC везде, где это возможно; в противном случае — время, как его показывает площадка. ISO 8601 без таймзоны.

rating_originalstring nullable

Исходная оценка в шкале площадки.

ratingnumber nullable

Оценка, приведённая к единой шкале 1–5. null, если оценки нет.

review_urlstring nullable

Прямая ссылка на отзыв на площадке. null, если недоступна.

reply_textstring nullable

Текст официального ответа организации. null, если ответа нет.

reply_datestring date-time nullable

Дата и время ответа организации (UTC, ISO 8601).

providerstring nullable

Площадка-источник самого отзыва внутри source (слаг в нижнем регистре). Многие площадки показывают в ленте отзывы других: 2ГИС — booking/tbank/flamp/…, Google — tripadvisor. У нативного отзыва совпадает со слагом площадки (2gis, google), и только на такой отзыв можно опубликовать ответ через эту площадку — на остальные вернётся 409 reply_not_replyable.

is_replyableboolean nullable

Можно ли ответить на отзыв через PUT /v3/reviews/{review_id}/reply. Приходит только на площадках, где Rewio публикует ответы (can_publish_reply в GET /v3/sources); на остальных ключа нет. true — ответы на ссылке подключены, и отзыв родной для площадки (provider пуст или равен source_slug). false — ответ вернёт ошибку: отзыв другой площадки (2ГИС показывает отзывы Netmonet, Booking, Т-Банка — 409 reply_not_replyable) или ответы на ссылке не подключены. Тариф флаг не учитывает.

has_imagesboolean required

Признак наличия изображений в отзыве.

has_videosboolean

Признак наличия видео в отзыве.

is_deletedboolean

Отзыв обнаружен удалённым на площадке (приходит только когда true).

deleted_atstring date-time nullable

Момент обнаружения удаления (UTC, ISO 8601).

is_hiddenboolean

Отзыв скрыт в рамках объекта (приходит только когда true).

is_pinnedboolean

Отзыв закреплён в рамках объекта (приходит только когда true).

pin_positioninteger nullable

Позиция закреплённого отзыва: меньше — выше.

prosstring nullable

Блок «достоинства» (только при split_pros_cons=true).

consstring nullable

Блок «недостатки» (только при split_pros_cons=true).

Example response

{
  "images": [
    {
      "image": "https://avatars.mds.yandex.net/get-altay/17743308/2a0000019f85dc34d7ee3b24b4b9ec82bdbd/XXXL",
      "preview": "https://avatars.mds.yandex.net/get-altay/17743308/2a0000019f85dc34d7ee3b24b4b9ec82bdbd/M",
      "template_url": "https://avatars.mds.yandex.net/get-altay/17743308/2a0000019f85dc34d7ee3b24b4b9ec82bdbd/{size}"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.