Справочник API
Коды ошибок
Полный справочник по каждому коду ошибки, который может вернуть API TokSpan, с описаниями и шагами по устранению.
Коды состояния HTTP
| Код | Значение | Действие |
|---|---|---|
| 200 | Успешно | Запрос выполнен успешно |
| 400 | Неверный запрос | Проверьте тело запроса на наличие некорректного JSON или отсутствующих обязательных полей |
| 401 | Не авторизован | Проверьте, что ваш API-ключ действителен и активен в панели управления |
| 402 | Требуется оплата | Недостаточный баланс — пополните счёт в разделе биллинга панели управления |
| 404 | Модель не найдена | Проверьте ID модели — см. доступные модели |
| 429 | Превышен лимит запросов | Реализуйте экспоненциальную задержку — см. лимиты запросов |
| 500 | Внутренняя ошибка | Проблема на стороне TokSpan — повторите запрос с задержкой или обратитесь в поддержку |
| 502 | Ошибка шлюза | Ошибка upstream-провайдера — может активироваться автоматическое переключение |
| 503 | Сервис недоступен | Временная перегрузка — повторите запрос через время, указанное в заголовке Retry-After |
Формат ответа с ошибкой
json
{
"error": {
"message": "Invalid API key",
"type": "authentication_error",
"code": "invalid_api_key"
}
}