Ссылка

Ошибки и ограничения скорости

Ошибки REST используют этот конверт. Сохраните идентификатор запроса на поддержку и никогда не регистрируйте свой ключ API:

Начните с кода и requestId

Стабильный код сообщает вашей программе, что произошло. Человекочитаемое сообщение объясняет этот запрос. Сохраняйте requestId при обращении в службу поддержки.

JSON error response

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is missing, invalid, or revoked.",
    "requestId": "req_..."
  }
}

Исправить ошибки аутентификации и планирования

Для 401 убедитесь, что заголовок начинается с Bearer, за которым следует один пробел и активный ключ. Для ошибки 403 проверьте план учетной записи и области, выбранные при создании ключа.

Исправить ошибки состояния загрузки

Для 409 или 422 убедитесь, что PUT завершен, Content-Type соответствует, а количество загруженных байтов равно sizeBytes. Создайте новое задание загрузки, если срок действия временного URL истек.

Код	HTTP	Значение
BAD_REQUEST	400 / 409	HTTP 400 означает, что тело запроса недействительно; HTTP 409 означает, что загрузка не может быть завершена в текущем состоянии.
UNAUTHORIZED	401	Ключ API отсутствует, недействителен или отозван.
PAID_PLAN_REQUIRED	403	В аккаунте нет подходящего платного плана.
INSUFFICIENT_SCOPE	403	Ключ API не включает необходимую область действия.
NOT_FOUND	404	Собственная загрузка, файл или общий ресурс не найден.
UPLOAD_NOT_READY	409	Загруженный объект не готов к завершению.
FILE_TOO_LARGE	413	Размер файла превышает допустимый предел.
OBJECT_VALIDATION_FAILED	422	Загруженный объект не прошел проверку.
QUOTA_EXCEEDED	429	Квота загрузки исчерпана.
RATE_LIMIT_EXCEEDED	429	Частота запросов API исчерпана.
SERVICE_UNAVAILABLE	503	Требуемая услуга временно недоступна.

Заголовки ограничения скорости

Повторите попытку 429 только после Retry-After. Повторите временную ошибку 503 с экспоненциальной задержкой. Не повторяйте автоматически недействительные запросы 400, 401 или 403.