Коды ошибок и отладка (Error Handling)
Подробный справочник кодов ошибок протокола HTTP, расшифровка структуры сообщений об ошибках и алгоритмы корректной повторной отправки (Retry with Exponential Backoff).
REFERENCE
HTTP Error Matrix Реестр кодов ошибок протокола HTTP и унифицированных JSON-сообщений платформы. Понимание кодов 400, 401, 402, 429 и 5xx позволяет клиентским SDK настроить детерминированное переключение на резервные модели и алгоритмы повторных попыток Exponential Backoff.
Матрица кодов ошибок
| Код HTTP | Тип ошибки | Причина и решение |
|---|---|---|
| 401 Unauthorized | auth_error | Неверный токен или ключ отозван. Проверьте заголовок Authorization: Bearer ... |
| 402 Payment Required | insufficient_quota | Недостаточно средств на рублевом балансе аккаунта. Пополните счет через СБП или картой |
| 429 Rate Limit | rate_limit_exceeded | Превышен лимит запросов в минуту (RPM). Примените задержку перед повторным вызовом |
| 500 / 503 Upstream | provider_error | Сбой на стороне узла апстрима. Шлюз автоматически задействует резервные модели |
Связанные разделы документации
Рекомендуем также изучить смежные технические руководства и спецификации: