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

StatusCodeWann
400INVALID_INPUTDer Body oder ein Argument passt nicht zur Operation: details listet die fehlerhaften Felder.
401MISSING_API_KEY, INVALID_API_KEY, EXPIRED_API_KEY, WORKSPACE_DELETEDKein Schlüssel, ein unbekannter oder widerrufener Schlüssel, ein abgelaufener Schlüssel, oder sein Workspace wurde gelöscht.
402INSUFFICIENT_TOKENSEine kostenpflichtige Operation, für die die Credits des Workspaces nicht reichen.
403FORBIDDENWer den Schlüssel erstellt hat, darf das in diesem Workspace nicht: dieselbe Regel wie in der App.
403PLAN_LIMIT_EXCEEDEDDer 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.
404NOT_FOUNDDiese Website, Unterhaltung, Aufgabe… gibt es in diesem Workspace nicht.
409CONFLICTLäuft bereits oder ist in einem Zustand, der das nicht erlaubt.
429RATE_LIMITEDZu viele Anfragen für den Workspace: Retry-After sagt, wann Sie es erneut versuchen können.
503SERVICE_UNAVAILABLEEin Dienst, den die Operation braucht, ist kurz nicht erreichbar: später erneut versuchen.
500INTERNAL_ERROREin 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
API120 Anfragen pro Minute
MCP30 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.

Bereit, Ihrer Website Aufschwung zu geben?

Stellen Sie Ihre erste Frage - semchat antwortet in Sekunden mit einem klaren Aktionsplan.

Kostenlos · ohne Anmeldung · in 5 Sekunden