довідка

Помилки та обмеження швидкості

Помилки REST використовують цей конверт. Зберігайте ідентифікатор запиту для підтримки та ніколи не реєструйте свій ключ API:

Почніть з коду та запиту

Стабільний код повідомляє вашій програмі, що сталося. Зрозуміле повідомлення пояснює цей запит. Зберігайте 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.