Riferimento e risoluzione dei problemi

Codici di errore e risoluzione dei problemi

Visualizza come Markdown

Formato di risposta all’errore

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

Gli errori aziendali di solito restituiscono ancora la struttura unificata JSON . Gli integratori dovrebbero controllare prima code . I fallimenti di autenticazione possono restituire HTTP 401; la limitazione del tasso può restituire HTTP 429.

Codici di errore comuni

Codice di erroreDescrizione
0Successo
1001Nessuna informazione valida di autenticazione non è fornita
1002Token scaduto
1003Token invalido, API Keyo firma
1004Token revocato
1006Fonte IP discrepanza
2001Parametro richiesto mancanza
2002Valore del parametro non valido
2003Parametro fuori portata
3001Equilibrio insufficiente
3003Ordine non trovato
3004Richiesta duplicata
3005L’ordine non può essere annullato
3006Permesso negato
3100 - 3112Errore di validazione dei parametri di ordine delle condizioni
5001Errore interno del server
5002Servizio temporaneamente non disponibile
5003Limite di velocità attivato

Risoluzione dei problemi

ProblemaRaccomandazione
1001 nessuna informazione valida di autenticazioneControlla se Authorization: Bearer <accessToken> o X-API-KEY è incluso.
1002 Token scadutoAggiorna il Token o accedi di nuovo prima di riprovare.
1003 Token, API Keyo firma non validaControlla API Key, payload firmata, corpo JSON stringa di richiesta e ordine dei parametri di query.
1006 fonte IP discrepanzaControlla la configurazione API Key IP whitelist.
3004 richiesta duplicataNon riutilizzare la stessa firma per percorsi legati all’ordine. Rigenerare timestamp e signature.
5003 limite di tasso attivatoRiduci la frequenza delle richieste e usa un backoff esponenziale se riprovi.
Timestamp outside of tolerance windowChiama /v1/time per calibrare l’offset temporale e firma di nuovo la richiesta.