Дополнительный сбор по объекту

Собирает новые отзывы со всех площадок объекта вне очереди. Ответ 202 приходит сразу, сбор идёт в фоне – обычно несколько минут.

Если в эти сутки с части площадок собрать не получилось, этот же вызов соберёт ещё раз только с них (mode: retry) – один раз. Правила целиком – на странице «Как работает дополнительный сбор отзывов».

Параметры

object_idчислообязательный

Объект, по которому нужно собрать отзывы.

Ответ

object_idчисло

Объект.

is_allowedда/нет

Запустит ли POST сбор прямо сейчас.

codeстрокаможет быть null

Почему нельзя – тот же код, что вернёт POST: refresh_requires_upgrade, refresh_trial_exhausted, refresh_in_progress, refresh_limited, refresh_nothing_to_scrape. null, если можно.

modeстрокаможет быть null

Что сделает POST: full – соберёт все включённые ссылки объекта, retry – только не собравшиеся в эти сутки. null, если нельзя.

is_runningда/нет

Идёт ли дополнительный сбор.

is_retriedда/нет

Повтор этих суток уже использован.

refreshed_atдата и времяможет быть null

Начало текущих суток объекта – последний сбор всех ссылок, UTC.

next_available_atдата и времяможет быть null

Когда снова будет доступен сбор всех ссылок, UTC. null – уже доступен.

retry_link_idsсписок чисел

Ссылки, не собравшиеся в эти сутки, которым положен один повтор.

trial_leftчисломожет быть null

Сколько дополнительных сборов осталось в пробном периоде (всего 5). null – не пробный период.

linksсписок объектов

Итог дополнительных сборов этих суток по ссылкам; повтор перекрывает первый сбор по своим ссылкам. Пусто вне суток объекта.

links[].link_idчисло

Ссылка объекта.

links[].statusстрока

running – собирается, success – собрана, failed – не собралась.

curl -X POST "https://api.rewio.ru/v3/objects/0/refresh"

{  "object_id": 20,  "is_allowed": false,  "code": "refresh_in_progress",  "mode": null,  "is_running": true,  "is_retried": false,  "refreshed_at": "2026-10-29T15:35:36",  "next_available_at": "2026-10-30T15:34:36",  "retry_link_ids": [],  "trial_left": null,  "links": [    {      "link_id": 177,      "status": "running"    },    {      "link_id": 178,      "status": "running"    },    {      "link_id": 179,      "status": "running"    }  ]}

Отказы: 402 refresh_requires_upgrade, 402 refresh_trial_exhausted, 409 refresh_in_progress, 409 refresh_nothing_to_scrape, 429 refresh_limited с заголовком Retry-After. Остальные коды общие для всего API и описаны на странице Ошибки.