Odkaz

Chyby a limity sadzieb

Chyby REST používajú túto obálku. Uchovajte si ID žiadosti pre podporu a nikdy neprihlasujte svoj kľúč API:

Začnite s kódom a requestId

Stabilný kód povie vášmu programu, čo sa stalo. Ľudsky čitateľná správa vysvetľuje túto požiadavku. Uložte requestId pri kontaktovaní podpory.

JSON error response

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

Opravte chyby overovania a plánovania

Pre 401 skontrolujte, či hlavička začína Nosičom, za ktorým nasleduje jedna medzera a aktívny kľúč. Pre 403 skontrolujte plán účtov a rozsahy vybrané pri vytváraní kľúča.

Opravte chyby stavu nahrávania

V prípade 409 alebo 422 potvrďte, že PUT skončilo, typ obsahu sa zhoduje a počet nahraných bajtov sa rovná sizeBytes. Ak vypršala platnosť dočasného URL, vytvorte novú úlohu nahrávania.

kód	HTTP	Význam
BAD_REQUEST	400 / 409	HTTP 400 znamená, že telo požiadavky je neplatné; HTTP 409 znamená, že nahrávanie nie je možné dokončiť v aktuálnom stave.
UNAUTHORIZED	401	Kľúč API chýba, je neplatný alebo je odvolaný.
PAID_PLAN_REQUIRED	403	Účet nemá vhodný platený program.
INSUFFICIENT_SCOPE	403	Kľúč API nezahŕňa požadovaný rozsah.
NOT_FOUND	404	Vlastné nahranie, súbor alebo zdieľanie sa nenašlo.
UPLOAD_NOT_READY	409	Odovzdaný objekt nie je pripravený na dokončenie.
FILE_TOO_LARGE	413	Súbor presahuje príslušný limit veľkosti.
OBJECT_VALIDATION_FAILED	422	Overenie nahraného objektu zlyhalo.
QUOTA_EXCEEDED	429	Kvóta nahrávania je vyčerpaná.
RATE_LIMIT_EXCEEDED	429	Miera žiadostí API je vyčerpaná.
SERVICE_UNAVAILABLE	503	Požadovaná služba je dočasne nedostupná.

Hlavičky s limitom rýchlosti

Opakovať 429 iba po Opakovať po. Zopakujte dočasné chyby 503 s exponenciálnym stiahnutím. Neskúšajte automaticky znova neplatné žiadosti 400, 401 alebo 403.