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

Сбор по папке собирает отзывы всех вложенных объектов, включая подпапки, – каждого по правилам дополнительного сбора. Запускается всё, что можно прямо сейчас: первый сбор за сутки или повтор для площадок, где не получилось. Остальные объекты пропускаются без ошибки.

В пробном периоде каждый запущенный объект тратит один из 5 дополнительных сборов. Если осталось меньше, чем объектов в папке, соберутся первые по порядку object_id.

Ответ 202 – состояние каждого объекта папки и started_object_ids, объекты, по которым сбор запущен этим запросом.

Параметры

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

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

Ответ

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

Состояние каждого объекта папки и её подпапок.

data[].object_idчисло

Объект.

data[].is_allowedда/нет

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

data[].codeстрокаможет быть null

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

data[].modeстрокаможет быть null

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

data[].is_runningда/нет

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

data[].is_retriedда/нет

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

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

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

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

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

data[].retry_link_idsсписок чисел

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

data[].trial_leftчисломожет быть null

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

data[].linksсписок объектов

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

data[].links[].link_idчисло

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

data[].links[].statusстрока

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

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

Объекты, по которым сбор запущен этим запросом.

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

{  "data": [    {      "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"        }      ]    },    {      "object_id": 21,      "is_allowed": false,      "code": "refresh_limited",      "mode": null,      "is_running": false,      "is_retried": false,      "refreshed_at": "2026-10-29T09:12:00",      "next_available_at": "2026-10-30T09:11:00",      "retry_link_ids": [],      "trial_left": null,      "links": [        {          "link_id": 184,          "status": "success"        },        {          "link_id": 185,          "status": "success"        }      ]    },    {      "object_id": 22,      "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": 190,          "status": "running"        }      ]    }  ],  "started_object_ids": [    20,    22  ]}

Если не запущен ни один объект, приходит отказ с причиной, как у объекта: 402 refresh_requires_upgrade, 402 refresh_trial_exhausted, 409 refresh_in_progress, 409 refresh_nothing_to_scrape, 429 refresh_limited. Остальные коды общие для всего API и описаны на странице Ошибки.