Fehler und Wiederholungen
API-Fehler verwenden ein einheitliches Format. Der Code ist für die Anwendungslogik; die Nachricht erklärt das Problem. Benutzereingaben intakt lassen und eine klare nächste Schritt anbieten.
Auf dieser Seite
Ein Fehlerformat#
Antworten enthalten keine Stacktraces, SQL, Token oder eine vollständige Antwort eines externen Anbieters. Zeigen Sie einem Kunden keine rohen internen Protokolle an.
{
"error": {
"code": "GATEWAY_NOT_CONNECTED",
"message": "Financial operations are temporarily unavailable. Try later or contact support."
}
}Gängige Fehlergruppen#
| HTTP | Beispiele | Nächster Schritt |
|---|---|---|
| 400 | INVALID_JSON, UNKNOWN_FIELD, INVALID_INPUT | Eingabe und erlaubte Felder prüfen |
| 401 | AUTH_REQUIRED, SESSION_EXPIRED | Erneut anmelden |
| 403 | INVALID_ORIGIN, CSRF_REQUIRED | Origin und aktuelle Sitzung prüfen |
| 404 | NOT_FOUND, TICKET_NOT_FOUND | Adresse und Eigentum prüfen |
| 409 | CHALLENGE_UNAVAILABLE | Eine neue Anmeldung starten |
| 410 | CHALLENGE_EXPIRED | Einen neuen Anmelde-Link erstellen |
| 413 | REQUEST_TOO_LARGE | Den Anforderungsbody verkleinern |
| 415 | JSON_REQUIRED | application/json senden |
| 429 | RATE_LIMITED | Häufigkeit reduzieren und warten |
| 503 | GATEWAY_NOT_CONNECTED, SERVICE_UNAVAILABLE | Verfügbarkeit prüfen oder es später versuchen |
Ratenlimits#
| Maßnahme | Limit |
|---|---|
| Anmeldung starten | 6 pro Minute pro gehashter Adresse |
| Eine Herausforderung prüfen | 90 pro Minute pro Herausforderung |
| Wissensfrage | 12 pro Minute pro gehashter Adresse mit D1 |
| Einen Server-Link erstellen | 20 pro Minute pro Benutzer |
| Händler-API | 90 Anforderungen pro Minute pro Schlüssel |
| Neue Anwendung | Fünf pro Tag pro Benutzer |
| Anwendung fortsetzen / Moderatorenentscheidung | 30 pro Minute pro Benutzer für jede Aktion |
| KI-Website-Überprüfung | 30 pro Stunde dienstweit |
| Kasse lesen oder Zahlungsversuch | 90 pro Minute pro gehashte Adresse |
| Supportanfrage erstellen | 6 pro Stunde pro Benutzer |
| Benachrichtigung testen | 3 pro Stunde pro Benutzer |
| KI-Generierung | 60 pro Stunde dienstweit standardmäßig |
Was erneut versucht werden kann#
Ein Lesevorgang kann nach einer Verzögerung bei einem vorübergehenden Netzwerkfehler erneut versucht werden. Bevor Sie eine Mutation erneut versuchen, prüfen Sie, ob der ursprüngliche Vorgang abgeschlossen wurde; eine verlorene Antwort beweist keinen Fehler.
Finanzielle Vorgänge erfordern Idempotenz und eine Serverstatusprüfung. Eine Client-Weiterleitung zu einer Ergebniseite ist kein Ersatz für eine Bestätigung.
Was in eine Anfrage aufgenommen werden soll#
- Die Seite und die Aktion unmittelbar vor dem Fehler.
- Uhrzeit, Zeitzone und der sichtbare Fehlercode.
- Ihre Rechnungs- oder Supportanfrage-Referenz, falls verfügbar.
- Eine kurze Beschreibung des erwarteten Ergebnisses.