Reference

Fejl og hastighedsgrænser

REST fejl bruger denne konvolut. Behold anmodningen ID for support, og log aldrig din API-nøgle:

Start med kode og requestId

Den stabile kode fortæller dit program, hvad der skete. Den menneskelæselige besked forklarer denne anmodning. Gem requestId, når du kontakter support.

JSON error response

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

Ret godkendelses- og planfejl

For 401 skal du kontrollere, at overskriften begynder med Bearer efterfulgt af et mellemrum og en aktiv nøgle. For 403 skal du kontrollere kontoplanen og de valgte omfang, da nøglen blev oprettet.

Ret upload-tilstandsfejl

For 409 eller 422 skal du bekræfte, at PUT er færdig, indholdstype matcher, og det uploadede byteantal er lig med sizeBytes. Opret et nyt uploadjob, hvis den midlertidige URL udløb.

Kode	HTTP	Betydning
BAD_REQUEST	400 / 409	HTTP 400 betyder, at anmodningsteksten er ugyldig; HTTP 409 betyder, at uploaden ikke kan fuldføres i dens nuværende tilstand.
UNAUTHORIZED	401	API-nøglen mangler, er ugyldig eller tilbagekaldt.
PAID_PLAN_REQUIRED	403	Kontoen har ikke en kvalificeret betalt plan.
INSUFFICIENT_SCOPE	403	Nøglen API inkluderer ikke det påkrævede omfang.
NOT_FOUND	404	Den ejede upload, fil eller share blev ikke fundet.
UPLOAD_NOT_READY	409	Det uploadede objekt er ikke klar til færdiggørelse.
FILE_TOO_LARGE	413	Filen overskrider den gældende størrelsesgrænse.
OBJECT_VALIDATION_FAILED	422	Det uploadede objekt mislykkedes i valideringen.
QUOTA_EXCEEDED	429	Uploadkvoten er opbrugt.
RATE_LIMIT_EXCEEDED	429	API anmodningshastigheden er opbrugt.
SERVICE_UNAVAILABLE	503	En påkrævet tjeneste er midlertidigt utilgængelig.

Rate-limit headers

Prøv igen 429 kun efter Retry-After. Prøv igen midlertidige 503-fejl med eksponentiel backoff. Prøv ikke automatisk at gentage ugyldige 400-, 401- eller 403-anmodninger.