API
Ошибки
Единый формат ошибок: HTTP-код + поле error. Платные сбои на нашей стороне не списывают токены.
Коды#
| HTTP | error | Значение |
|---|---|---|
| 400 | value or a typed param is required · unknown_base · ambiguous_params · not_a_pdf | Неверный запрос. Списания нет. |
| 401 | Unauthorized | Отсутствует/неверный X-API-Key. |
| 402 | insufficient_tokens | Недостаточно токенов. Тело: function_code, required, available. |
| 403 | function_unavailable · API key is not allowed to use … | Функция отключена или у ключа нет доступа. |
| 413 | payload_too_large | Загрузка больше лимита размера. |
| 415 | unsupported_content_type | Неверный content-type. |
| 429 | rate limit / daily cap | Слишком часто / достигнут дневной лимит. |
| 503 | billing_unavailable · aml_unavailable · needs_async | Временная ошибка, повторите позже. Не списывается. |
Идемпотентность#
GET-проверки безопасно повторять. Для POST временная 5xx означает, что вызов не выполнился и не списан — повтор безопасен.