13.04.2026 10:45

Отчеты

Раздел содержит методы API, используемые при взаимодействии с отчетами сервиса REGOS.

При построении отчёта происходит обработка большого объёма данных.

Запросы на построение отчётов выполняются через очередь.

Основные методы:

Важно: В очередь нельзя добавить более 3-х отчётов одновременно.
Важно: Методы Report/SetPrepared и Report/SetError требуют Bearer авторизацию по схеме Introspection и scope regos.api.report.

ReportRequest оставлен для обратной совместимости.
Методы ReportPrepared/Get, ReportPrepared/Save, ReportPrepared/Remove помечены как устаревшие и поддерживаются до 10.04.2027.
После подготовки, отчёт будет храниться на сервере в течение периода, указанного в настройке REPORT_PREPARED_REPORT_LIFETIME (по умолчанию 5 дней). Готовый отчёт можно сохранить с помощью запроса ReportPrepared/Save, в данном случае отчёт будет хранится до удаления или периодической очистки серверов. Удалить сохранённый отчёт рекомендуется методом Report/RemovePrepared.
Подготовленный отчёт рекомендуется получать методом Report/GetPrepared - в параметр запроса request_uuid передаётся значение new_uuid, полученное в ответе запроса на постановку отчёта в очередь (для получения отчёта с данными необходимо передать параметр "include_data": true). Каждый отчёт содержит разные данные в зависимости от типа отчёта.