Referentie

Fouten en tarieflimieten

REST-fouten gebruiken deze envelop. Bewaar het verzoek ID voor ondersteuning en log nooit uw API-sleutel:

Begin met code en requestId

De stabiele code vertelt uw programma wat er is gebeurd. Het voor mensen leesbare bericht legt dit verzoek uit. Bewaar requestId wanneer u contact opneemt met de ondersteuning.

JSON error response

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

Herstel authenticatie- en planfouten

Controleer voor 401 of de koptekst begint met Bearer, gevolgd door één spatie en een actieve sleutel. Controleer voor 403 het accountplan en de bereiken die zijn geselecteerd toen de sleutel werd gemaakt.

Fouten in de uploadstatus oplossen

Voor 409 of 422 bevestigt u dat de PUT is voltooid, dat het inhoudstype overeenkomt en dat het aantal geüploade bytes gelijk is aan sizeBytes. Maak een nieuwe uploadtaak als de tijdelijke URL is verlopen.

Code	HTTP	Betekenis
BAD_REQUEST	400 / 409	HTTP 400 betekent dat de verzoektekst ongeldig is; HTTP 409 betekent dat de upload in de huidige staat niet kan worden voltooid.
UNAUTHORIZED	401	De API-sleutel ontbreekt, is ongeldig of is ingetrokken.
PAID_PLAN_REQUIRED	403	Het account beschikt niet over een in aanmerking komend betaald abonnement.
INSUFFICIENT_SCOPE	403	De sleutel API heeft niet het vereiste bereik.
NOT_FOUND	404	De eigen upload, het bestand of het gedeelde bestand is niet gevonden.
UPLOAD_NOT_READY	409	Het geüploade object is niet gereed voor voltooiing.
FILE_TOO_LARGE	413	Het bestand overschrijdt de toepasselijke groottelimiet.
OBJECT_VALIDATION_FAILED	422	Het geüploade object is niet gevalideerd.
QUOTA_EXCEEDED	429	Het uploadquotum is bereikt.
RATE_LIMIT_EXCEEDED	429	De API-aanvraagsnelheid is opgebruikt.
SERVICE_UNAVAILABLE	503	Een vereiste dienst is tijdelijk niet beschikbaar.

Kopteksten met snelheidslimiet

Probeer 429 alleen opnieuw na Retry-After. Probeer tijdelijke 503-fouten opnieuw met exponentieel uitstel. Probeer ongeldige 400-, 401- of 403-aanvragen niet automatisch opnieuw.