Referenz

Fehler und Ratenlimits

REST-Fehler verwenden diesen Umschlag. Behalten Sie die Anfrage ID für Support und protokollieren Sie niemals Ihren API-Schlüssel:

Beginnen Sie mit Code und requestId

Der stabile Code teilt Ihrem Programm mit, was passiert ist. Die für Menschen lesbare Nachricht erläutert diese Anfrage. Speichern Sie requestId, wenn Sie den Support kontaktieren.

JSON error response

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

Beheben Sie Authentifizierungs- und Planfehler

Überprüfen Sie bei 401, ob der Header mit Bearer beginnt, gefolgt von einem Leerzeichen und einem aktiven Schlüssel. Überprüfen Sie für 403 den Kontoplan und die Bereiche, die beim Erstellen des Schlüssels ausgewählt wurden.

Beheben Sie Fehler im Upload-Status

Bestätigen Sie für 409 oder 422, dass PUT abgeschlossen ist, der Inhaltstyp übereinstimmt und die Anzahl der hochgeladenen Bytes sizeBytes entspricht. Erstellen Sie einen neuen Upload-Job, wenn das temporäre URL abgelaufen ist.

Code	HTTP	Bedeutung
BAD_REQUEST	400 / 409	HTTP 400 bedeutet, dass der Anforderungstext ungültig ist; HTTP 409 bedeutet, dass der Upload im aktuellen Status nicht abgeschlossen werden kann.
UNAUTHORIZED	401	Der Schlüssel API fehlt, ist ungültig oder widerrufen.
PAID_PLAN_REQUIRED	403	Das Konto verfügt nicht über einen berechtigten kostenpflichtigen Plan.
INSUFFICIENT_SCOPE	403	Der Schlüssel API enthält nicht den erforderlichen Bereich.
NOT_FOUND	404	Der eigene Upload, die Datei oder die Freigabe wurde nicht gefunden.
UPLOAD_NOT_READY	409	Das hochgeladene Objekt ist nicht zur Fertigstellung bereit.
FILE_TOO_LARGE	413	Die Datei überschreitet die geltende Größenbeschränkung.
OBJECT_VALIDATION_FAILED	422	Die Validierung des hochgeladenen Objekts ist fehlgeschlagen.
QUOTA_EXCEEDED	429	Das Upload-Kontingent ist erschöpft.
RATE_LIMIT_EXCEEDED	429	Die Anfragerate API ist erschöpft.
SERVICE_UNAVAILABLE	503	Ein erforderlicher Dienst ist vorübergehend nicht verfügbar.

Rate-Limit-Header

Wiederholen Sie 429 erst nach „Retry-After“. Wiederholen Sie temporäre 503-Fehler mit exponentiellem Backoff. Versuchen Sie ungültige 400-, 401- oder 403-Anfragen nicht automatisch erneut.