13.04.2026 10:45

SetError

[POST] …/v1/report/seterror

Метод устанавливает ошибку по запросу отчёта.

Важно:

  • метод требует авторизации: [Authorize(AuthenticationSchemes = "Introspection", Policy = "regos.api.report")];
  • обязательный заголовок: Authorization: Bearer <access_token>;
  • в access token должен присутствовать scope regos.api.report;
  • метод проверяет, что request_uuid существует и находится в статусе 0 (InProcess);
  • если проверка успешна, в report_rep_request_ref.rrep_errors записывается текст ошибки, а rrep_status меняется на 2 (Error);
  • после успешного завершения отправляется ReportError webhook и sockethook;
  • после успешного завершения отправляется уведомление только пользователю, который создал отчёт.

Входные параметры

Название Тип данных Обязательность Описание параметра
request_uuid string Обязательный UUID запроса отчёта
api_login string Обязательный ApiLogin аккаунта, в котором нужно установить ошибку
message string Обязательный Текст ошибки

Пример запроса

{
  "request_uuid": "9006f149-aa49-4b8e-ba69-386d945fa738",
  "api_login": "DEMO",
  "message": "Ошибка формирования отчёта во внешнем сервисе"
}

Выходные параметры

Название Тип данных Описание параметра
row_affected Int64 Количество изменённых строк

Пример ответа

{
  "ok": true,
  "result": {
    "row_affected": 1
  }
}