DokumentationAPI & MCP
Fehler und Limits
Die Fehlercodes, was sie bedeuten und wie viele Aufrufe pro Minute möglich sind.
Ein Fehler antwortet { "error": { "code": "…", "message": "…" } } mit seinem HTTP-Status. Über MCP lautet die Meldung des Tool-Fehlers CODE: message. Werten Sie den Code aus, nicht die Meldung.
Fehlercodes
| Status | Code | Wann |
|---|---|---|
400 | INVALID_INPUT | Der Body oder ein Argument passt nicht zur Operation: details listet die fehlerhaften Felder. |
401 | MISSING_API_KEY, INVALID_API_KEY, EXPIRED_API_KEY, WORKSPACE_DELETED | Kein Schlüssel, ein unbekannter oder widerrufener Schlüssel, ein abgelaufener Schlüssel, oder sein Workspace wurde gelöscht. |
402 | INSUFFICIENT_TOKENS | Eine kostenpflichtige Operation, für die die Credits des Workspaces nicht reichen. |
403 | FORBIDDEN | Wer den Schlüssel erstellt hat, darf das in diesem Workspace nicht: dieselbe Regel wie in der App. |
403 | PLAN_LIMIT_EXCEEDED | Der Plan des Workspaces enthält es nicht: bei einem Konto, das noch nie bezahlt hat, die Backlinks eines Wettbewerbers oder die Analyse eines verborgenen Wettbewerbers. |
404 | NOT_FOUND | Diese Website, Unterhaltung, Aufgabe… gibt es in diesem Workspace nicht. |
409 | CONFLICT | Läuft bereits oder ist in einem Zustand, der das nicht erlaubt. |
429 | RATE_LIMITED | Zu viele Anfragen für den Workspace: Retry-After sagt, wann Sie es erneut versuchen können. |
503 | SERVICE_UNAVAILABLE | Ein Dienst, den die Operation braucht, ist kurz nicht erreichbar: später erneut versuchen. |
500 | INTERNAL_ERROR | Ein Fehler auf unserer Seite: später erneut versuchen. |
402
{
"error": {
"code": "INSUFFICIENT_TOKENS",
"message": "Workspace is out of tokens for this period."
}
}Aufruflimits
| Pro Workspace | |
|---|---|
| API | 120 Anfragen pro Minute |
| MCP | 30 Tool-Aufrufe pro Minute |
Über dem Limit lautet die Antwort 429 RATE_LIMITED, mit einem Header Retry-After, der sagt, wann Sie es erneut versuchen können.
Keine Antwort auf Ihre Frage gefunden? Schreiben Sie uns.

