справка

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

REST грешките използват този плик. Запазете ID на заявката за поддръжка и никога не регистрирайте вашия 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 само след повторен опит след. Повторен опит за временни грешки 503 с експоненциално забавяне. Не опитвайте автоматично повторно невалидни 400, 401 или 403 заявки.