reviews

Синхронизация отзывов: поток изменений с курсором

Отзывы, изменившиеся у нас после точки, на которой вы остановились.

Первый запрос — с адресом (object_id или folder_id), дальше достаточно cursor из предыдущего ответа. next_cursor приходит всегда, в том числе на последней и на пустой странице: это закладка, которую вы храните между прогонами.

Порядок фиксирован (от давних изменений к свежим) и не настраивается, фильтров нет. Строки могут повторяться между страницами — применяйте upsert по id, потерять строку поток не может.

get/v3/reviews/sync

Request

  • Base URL: https://api.rewio.ru
  • URL: https://api.rewio.ru/v3/reviews/sync
  • Auth: API key in header X-API-Key

Query parameters

folder_idinteger nullable

Синхронизировать папку целиком: все объекты папки и её подпапок. Взаимоисключима с object_id — ровно один из двух.

cursorstring nullable

Курсор из next_cursor предыдущего ответа. С ним остальные параметры можно не передавать — адресат, режим и размер страницы запечены внутри.

modestring nullable

Что присылать:

  • all (по умолчанию) — и новые отзывы, и изменения. Полная актуальная копия.
  • new — только впервые появившиеся отзывы. Правки, ответы и пропажи не приходят; каждый отзыв приходит один раз в жизни, апсерт не нужен.

Режима «только изменения» нет намеренно: клиенту, который уже догнал текущее состояние, режим all ровно его и отдаёт — новых пока нет, приходят одни правки.

limitinteger nullable

Размер страницы (1–1000). По умолчанию 100.

object_idinteger nullable

Идентификатор объекта. Взаимоисключим с folder_id — в запросе должен быть ровно один из двух.

Response

Successful Response

next_cursorstring required

Курсор для следующего запроса. Приходит всегда, в том числе на последней и на пустой странице — его и нужно сохранить у себя до следующего прогона.

has_nextboolean required

Есть ли ещё элементы прямо сейчас. false — обход догнал текущее состояние; возвращайтесь с сохранённым курсором позже.

Example response

{
  "data": [
    {
      "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.