Обработка ошибок и диагностика
Диагностика, стратегия повторов и ссылки на справочник кодов ошибок.
Ищете хаб Gonka API ? Начните здесь.
Справочник API
Полные коды ошибок и примеры смотрите в справочнике API:
- Список кодов ошибок — статусы, причины и шаги исправления.
- Примеры обработки ошибок — готовые паттерны для повторов и фолбэков.
- Заголовок предупреждения о низком балансе — показывайте предупреждения до того, как запросы начнут падать.
Чеклист диагностики
Соберите эти данные перед повтором или эскалацией:
- HTTP-статус и код ошибки
- Request ID или трассировка из заголовков ответа
- Тело запроса (без секретов) и ID модели
- Пользовательский или фоновый сценарий
Стратегия повторов
Повторяйте запросы только когда это безопасно и учитывайте Retry-After.
- Повторяйте 429/503/504 с экспоненциальной паузой
- Не повторяйте 401/402/403 без действий пользователя
- Используйте idempotency keys для фоновых задач
