Odkaz

Chyby a limity sazeb

Chyby REST používají tuto obálku. Uschovejte si ID požadavku pro podporu a nikdy nepřihlašujte svůj API klíč:

Začněte kódem a requestId

Stabilní kód říká vašemu programu, co se stalo. Lidsky čitelná zpráva vysvětluje tento požadavek. Při kontaktování podpory uložte requestId.

JSON error response

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

Opravte chyby ověřování a plánování

U 401 zkontrolujte, zda záhlaví začíná Nosičem, za nímž následuje jedna mezera a aktivní klíč. Pro 403 zkontrolujte plán účtů a rozsahy vybrané při vytváření klíče.

Opravte chyby stavu nahrávání

U 409 nebo 422 potvrďte, že PUT skončilo, odpovídá typu Content-Type a počet nahraných bajtů se rovná sizeBytes. Pokud vypršela platnost dočasného URL, vytvořte novou úlohu nahrávání.

Kód	HTTP	Význam
BAD_REQUEST	400 / 409	HTTP 400 znamená, že tělo požadavku je neplatné; HTTP 409 znamená, že nahrávání nelze dokončit v aktuálním stavu.
UNAUTHORIZED	401	Klíč API chybí, je neplatný nebo odvolán.
PAID_PLAN_REQUIRED	403	Účet nemá vhodný placený plán.
INSUFFICIENT_SCOPE	403	Klíč API nezahrnuje požadovaný rozsah.
NOT_FOUND	404	Vlastněné nahrání, soubor nebo sdílené položky nebyly nalezeny.
UPLOAD_NOT_READY	409	Nahraný objekt není připraven k dokončení.
FILE_TOO_LARGE	413	Soubor překračuje platný limit velikosti.
OBJECT_VALIDATION_FAILED	422	Ověření nahraného objektu se nezdařilo.
QUOTA_EXCEEDED	429	Kvóta pro nahrávání je vyčerpána.
RATE_LIMIT_EXCEEDED	429	Míra požadavků API je vyčerpána.
SERVICE_UNAVAILABLE	503	Požadovaná služba je dočasně nedostupná.

Záhlaví s omezením rychlosti

Opakujte 429 pouze po Retry-After. Opakujte dočasné chyby 503 s exponenciálním stažením. Nepokoušejte se automaticky opakovat neplatné požadavky 400, 401 nebo 403.