Referenz & Fehlerbehebung

Fehlercodes und Fehlerbehebung

Als Markdown anzeigen

Fehlerantwort-Format

1{
2  "code": 1003,
3  "message": "Invalid token",
4  "requestId": "req-12345678"
5}

Geschäftsfehler geben in der Regel weiterhin die einheitliche JSON zurück. Integratoren sollten code zuerst überprüfen. Authentifizierungsfehler können HTTP 401; Zinsbegrenzung kann HTTP 429zurückführen.

Häufige Fehlercodes

FehlercodeBeschreibung
0Erfolg
1001Keine gültigen Authentifizierungsinformationen bereitgestellt
1002Token abgelaufen
1003Ungültiges Token, API Keyoder Signatur
1004Token widerrufen
1006Quelle IP Mismatch
2001Fehlender erforderlicher Parameter
2002Ungültiger Parameterwert
2003Parameter außerhalb des Bereichs
3001Unzureichendes Gleichgewicht
3003Ordnung nicht gefunden
3004Doppelte Anfrage
3005Bestellung kann nicht storniert werden
3006Erlaubnis abgelehnt
3100 - 3112Fehler zur Validierung von Bedingungsparametern
5001Interner Serverfehler
5002Dienst vorübergehend nicht verfügbar
5003Ausgelöste Ratenbegrenzung

Fehlerbehebung

ProblemEmpfehlung
1001 keine gültigen AuthentifizierungsinformationenPrüfen Sie, ob Authorization: Bearer <accessToken> oder X-API-KEY enthalten ist.
1002 Token abgelaufenAktualisieren Sie den Token oder melden Sie sich erneut an, bevor Sie es erneut versuchen.
1003 ungültiges Token, API Keyoder SignaturÜberprüfen Sie API Key, Signaturnutzlast, Request-Body JSON String und Reihenfolge der Abfrageparameter.
1006 Quelle IP DiskrepanzÜberprüfe die Konfiguration der API Key IP Whitelist.
3004 Duplikat-AnfrageVerwenden Sie dieselbe Signatur nicht für ordnungsbezogene Pfade wieder. Regeneriere timestamp und signature.
5003 Rate-Limit ausgelöstReduziere die Anfragefrequenz und nutze exponentiellen Backoff, wenn du es erneut versuchst.
Timestamp outside of tolerance windowRufen Sie /v1/time an, um den Zeitversatz zu kalibrieren und den Antrag erneut zu unterschreiben.