Odniesienie i rozwiązywanie problemów

Kody błędów i rozwiązywanie problemów

Zobacz jako Markdown

Format odpowiedzi na błędy

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

Błędy biznesowe zazwyczaj nadal zwracają zunifikowaną strukturę JSON . Integratory powinny najpierw code sprawdzić. Niepowodzenia uwierzytelniania mogą zwracać HTTP 401; ograniczenie szybkości może zwracać HTTP 429.

Typowe kody błędów

Kod błęduOpis
0Sukces
1001Brak podanych ważnych informacji uwierzytelniających
1002Token wygasł
1003Nieprawidłowy token, API Keylub sygnatura
1004Token cofnięty
1006Źródło IP niezgodności
2001Brakujący wymagany parametr
2002Nieprawidłowa wartość parametru
2003Parametr poza zakresem
3001Niewystarczająca równowaga
3003Nie znaleziono porządku
3004Podwójne żądanie
3005Zamówienia nie można anulować
3006Pozwolenie odrzucone
3100 - 3112Błąd walidacji parametrów kolejności warunków
5001Wewnętrzny błąd serwera
5002Usługa tymczasowo niedostępna
5003Uruchomienie limitu stawek

Rozwiązywanie problemów

ProblemRekomendacja
1001 brak ważnych informacji uwierzytelniającychSprawdź, czy Authorization: Bearer <accessToken> czy X-API-KEY jest w cenie.
1002 Token wygasłOdśwież Token lub zaloguj się ponownie, zanim spróbujesz ponownie.
1003 nieprawidłowy Token, API Keylub sygnaturaSprawdź API Key, ładunek podpisu, ciało żądania JSON ciąg oraz zapytanie o kolejność parametrów.
1006 źródło IP niezgodnościSprawdź konfigurację API Key IP białej listy.
3004 duplikat prośbyNie używaj tego samego podpisu ponownie dla ścieżek związanych z porządkiem. Generuj timestamp i signature.
5003 uruchomiony limit prędkościZmniejsz częstotliwość żądań i stosuj wykładnicze cofanie się przy ponownych próbach.
Timestamp outside of tolerance windowZadzwoń do /v1/time , aby skalibrować przesunięcie czasu i podpisz wniosek ponownie.