Referens

Fel och hastighetsgränser

REST-fel använder detta kuvert. Behåll begäran-ID för support och logga aldrig din API-nyckel:

Börja med kod och requestId

Den stabila koden berättar för ditt program vad som hände. Det mänskliga läsbara meddelandet förklarar denna begäran. Spara requestId när du kontaktar support.

JSON error response

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

Åtgärda autentiserings- och planfel

För 401, kontrollera att rubriken börjar med Bearer följt av ett mellanslag och en aktiv nyckel. För 403, kontrollera kontoplanen och de omfång som valdes när nyckeln skapades.

Åtgärda uppladdningstillståndsfel

För 409 eller 422, bekräfta att PUT är klar, innehållstyp matchar och antalet uppladdade byte är lika med sizeBytes. Skapa ett nytt uppladdningsjobb om den tillfälliga URL har löpt ut.

Kod	HTTP	Mening
BAD_REQUEST	400 / 409	HTTP 400 betyder att begäranden är ogiltig; HTTP 409 betyder att uppladdningen inte kan slutföras i sitt nuvarande tillstånd.
UNAUTHORIZED	401	Nyckeln API saknas, är ogiltig eller återkallad.
PAID_PLAN_REQUIRED	403	Kontot har inte en kvalificerad betalplan.
INSUFFICIENT_SCOPE	403	Nyckeln API inkluderar inte det nödvändiga omfånget.
NOT_FOUND	404	Den ägda uppladdningen, filen eller delningen hittades inte.
UPLOAD_NOT_READY	409	Det uppladdade objektet är inte klart för slutförande.
FILE_TOO_LARGE	413	Filen överskrider den tillämpliga storleksgränsen.
OBJECT_VALIDATION_FAILED	422	Det uppladdade objektet misslyckades med valideringen.
QUOTA_EXCEEDED	429	Uppladdningskvoten är slut.
RATE_LIMIT_EXCEEDED	429	Begäran API är förbrukad.
SERVICE_UNAVAILABLE	503	En obligatorisk tjänst är inte tillgänglig för tillfället.

Rate-limit rubriker

Försök igen 429 först efter Försök igen-efter. Försök igen tillfälliga 503-fel med exponentiell backoff. Försök inte automatiskt igen ogiltiga 400-, 401- eller 403-förfrågningar.