Fehler und Limits

Fehlerformat

{
  "error": {
    "code": "missing_scope",
    "message": "Missing scope: property:read",
    "requestId": "example-request-id"
  }
}

details kann zusätzliche Informationen enthalten. Protokollieren Sie Status, Fehlercode und X-Request-Id, ohne den geheimen Token zu speichern.

HTTP	Bedeutung und nächster Schritt
400	JSON, Felder oder Filter prüfen. Validierungsdetails auswerten.
401	Token fehlt, ist ungültig, abgelaufen oder widerrufen; auch ein inaktiver Ersteller kann die Ursache sein.
402	Kontingent überschritten. Angegebenen Verbrauch und Tarif prüfen.
403	Fehlender Scope, eingeschränkter Objektzugriff oder suspendierte Organisation.
404	Datensatz nicht gefunden oder für diese Anfrage nicht sichtbar.
429	Anfragebudget erreicht. `Retry-After` beachten.
500	Serverfehler. Request-ID für die Untersuchung aufbewahren.

Rate Limits

Das Standardbudget beträgt 60 Anfragen pro Minute und Token; ein Token kann ein eigenes Limit haben. Authentifizierte Antworten enthalten X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset. Bei 429 verwenden Sie Retry-After als Wartehinweis; starten Sie keine enge Wiederholungsschleife anhand des Reset-Headers. Reduzieren Sie Parallelität und bündeln Sie Abfragen sinnvoll. Wiederholen Sie fehlgeschlagene Schreiboperationen erst, nachdem Sie deren Ergebnis geprüft haben. Fehlende Rechte oder ungültige Eingaben werden durch häufigeres Wiederholen nicht behoben.

Grundlagen

Ordner

Projekte

Einheiten

Importe

Fehler und Limits

Fehlerformat

Rate Limits

​Fehlerformat

​Rate Limits

Fehlerformat

Rate Limits