Коды ошибок отчётов (mpbx-api reports, mpbx-cdr)
Коды, которые возвращают маршруты отчётов (W4-RPT-01). Типы ошибок соответствуют HTTP-статусам, как в
общих кодах; коды ниже, которым нужен другой статус, об этом сообщают. Сообщения никогда
не содержат данных о вызовах. Читатель также возвращает MPBX-CDR-UNREADABLE (cdr.md) и
коды MPBX-CH-* из storage.md. Руководство: docs/guides/reports.md.
| Код | HTTP | Значение | Что делать |
|---|---|---|---|
MPBX-REPORT-BAD-PERIOD | 400 | from не раньше until или период длиннее 366 дней. Метка времени, которая не соответствует RFC 3339, возвращает MPBX-INVALID-QUERY с указанием поля. | Передавайте from и until в формате RFC 3339, при этом from должна быть раньше, а разница между ними не больше 366 дней. Чтобы получить отчёт за последние 7 дней, не передавайте оба параметра. |
MPBX-CDR-EXPORT-UNAVAILABLE | 501 | Для запрошенного формата экспорта не установлен кодировщик (сборка или тест, в которых установлен только CSV). | Используйте format=csv. |
MPBX-CDR-EXPORT-TOO-LARGE | 413 | Файл слишком большой для своего формата: PDF содержит не более 20 000 строк, таблица Excel не более 1 048 575. | Используйте format=csv или сузьте отчёт. |
MPBX-RBAC-FORBIDDEN | 403 | У вызывающего нет права reports:read. | Попросите роль Супервайзер, Администратор отдела, Менеджер или Владелец (либо пользовательскую роль с reports:read). |
MPBX-API-NOT-CONFIGURED | 503 | Сервер запущен без clickhouse.url, поэтому истории вызовов и очередей для отчётов нет. | Укажите [clickhouse] url и перезапустите сервер. |
MPBX-REPORT-SCHEDULE-INVALID | 500 | В сохранённом расписании отчёта указан отчёт или формат, которые сервер не знает (ошибка данных; расписание отключается, а в last_error записывается этот код). Маршруты API этот код не возвращают, так как проверяют входные данные. | Удалите расписание и создайте его заново. Если ошибка повторяется, сообщите о ней. |