Jeder Fehler verwendet dieselbe JSON-Struktur, sodass ein einziger Handler alle abdeckt.
{
"error": {
"code": "forbidden",
"message": "this API key is missing the \"write\" scope"
}
}
Statuscodes
| Status | code | Wann |
|---|---|---|
| 400 | validation_error | Der Body oder die Query ist bei der Validierung fehlgeschlagen. error.fields nennt jedes Feld |
| 401 | unauthorized | Der Schlüssel fehlt, ist ungültig, widerrufen oder deaktiviert |
| 402 | plan_limit | Ihr Tarif enthält dies nicht, oder ein Tariflimit wurde erreicht |
| 403 | forbidden | Dem Schlüssel fehlt der Scope, den dieser Endpunkt benötigt |
| 404 | not_found | Die Ressource existiert in diesem Workspace nicht |
| 429 | rate_limited | Zu viele Anfragen mit diesem Schlüssel |
| 500 | internal_error | Auf unserer Seite ist etwas schiefgelaufen. Wiederholen Sie den Versuch mit Backoff |
Rate-Limits
Jeder Schlüssel kann 120 Anfragen alle 60 Sekunden ausführen, gemeinsam für die REST API und den MCP-Server. Antworten enthalten die Standard-Header RateLimit und RateLimit-Policy, sodass Sie die Geschwindigkeit drosseln können, bevor Sie das Limit erreichen.
Gute Praxis
- Wiederholen Sie
429- und5xx-Antworten mit exponentiellem Backoff. Wiederholen Sie keine4xx-Fehler außer429. - Bewahren Sie Schlüssel auf Ihrem Server auf. Geben Sie sie niemals in einem Browser oder einer mobilen App weiter.
- Verwenden Sie für jede App einen separaten Schlüssel, damit Sie einen rotieren oder widerrufen können, ohne die anderen zu beeinträchtigen.
War das hilfreich?
Markengerechte Beiträge in Minuten veröffentlichen
Zur Dokumentation zurückKI-Inhalte, Planung, Interaktion und eine komplette Marketing-Suite — kostenlos starten.
Kostenlos starten
