Referanse

Feil og hastighetsgrenser

REST feil bruker denne konvolutten. Ta vare på forespørselen ID for støtte, og loggfør aldri API-nøkkelen din:

Start med kode og requestId

Den stabile koden forteller programmet ditt hva som skjedde. Den menneskelig lesbare meldingen forklarer denne forespørselen. Lagre requestId når du kontakter kundestøtte.

JSON error response

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

Rett opp autentiserings- og planfeil

For 401, sjekk at overskriften begynner med Bearer etterfulgt av ett mellomrom og en aktiv nøkkel. For 403, sjekk kontoplanen og omfangene som ble valgt da nøkkelen ble opprettet.

Rett opp opplastingstilstandsfeil

For 409 eller 422, bekreft at PUT er fullført, at innholdstypen samsvarer, og at antallet opplastede byte er lik sizeBytes. Opprett en ny opplastingsjobb hvis den midlertidige URL har utløpt.

Kode	HTTP	Betydning
BAD_REQUEST	400 / 409	HTTP 400 betyr at forespørselsteksten er ugyldig; HTTP 409 betyr at opplastingen ikke kan fullføres i sin nåværende tilstand.
UNAUTHORIZED	401	API-nøkkelen mangler, er ugyldig eller tilbakekalt.
PAID_PLAN_REQUIRED	403	Kontoen har ikke en kvalifisert betalt plan.
INSUFFICIENT_SCOPE	403	API-nøkkelen inkluderer ikke det nødvendige omfanget.
NOT_FOUND	404	Den eide opplastingen, filen eller delingen ble ikke funnet.
UPLOAD_NOT_READY	409	Det opplastede objektet er ikke klart for fullføring.
FILE_TOO_LARGE	413	Filen overskrider gjeldende størrelsesgrense.
OBJECT_VALIDATION_FAILED	422	Det opplastede objektet mislyktes i valideringen.
QUOTA_EXCEEDED	429	Opplastingskvoten er oppbrukt.
RATE_LIMIT_EXCEEDED	429	Forespørselskvoten for API er oppbrukt.
SERVICE_UNAVAILABLE	503	En nødvendig tjeneste er midlertidig utilgjengelig.

Hastighetsgrenseoverskrifter

Prøv 429 på nytt bare etter «Forsøk-etter». Prøv midlertidige 503-feil på nytt med eksponentiell tilbaketrekking. Ikke prøv ugyldige 400-, 401- eller 403-forespørsler på nytt automatisk.