Коды ошибок

Понимание ответов API об ошибках

Формат ответа с ошибкой
Все сообщения об ошибках имеют следующий формат:
{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "Human-readable error message"
  }
}
Коды ошибок
400Bad Request

Параметры запроса недействительны или некорректно сформированы.

Решение: Проверьте тело запроса и убедитесь, что все обязательные поля присутствуют и содержат корректные значения.

401Unauthorized

Неверный или отсутствующий API-ключ.

Решение: Убедитесь, что вы добавляете действительный API-ключ в заголовок Authorization.

402Payment Required

Недостаточно средств на вашем API-кошельке.

Решение: Приобретите дополнительные кредиты или дождитесь их пополнения.

403Forbidden

Доступ к API не подтверждён или ваш аккаунт заблокирован.

Решение: Свяжитесь со службой поддержки, если считаете, что произошла ошибка.

404Not Found

Запрашиваемый ресурс (задача, вебхук и т.д.) не найден.

Решение: Убедитесь, что идентификатор ресурса указан верно.

429Too Many Requests

Слишком много запросов за короткий период времени.

Решение: Реализуйте экспоненциальную отсрочку и соблюдайте ограничения по частоте запросов.

500Internal Server Error

На нашей стороне произошла ошибка.

Решение: Повторите запрос после небольшой задержки. Если проблема не устранена, обратитесь в службу поддержки.

Ограничения по частоте запросов
Ограничения по умолчанию:
МетрикаЛимит
Запросов в минуту60
Запросов в день10,000
Параллельные задачи5
Nano Banana Pro API