Kody błędów
Kody błędów mają dwie warstwy. Zewnętrzne pole code odzwierciedla wynik warstwy API, a data.bizCode wynik biznesowy. Wywołanie zakończyło się sukcesem tylko wtedy, gdy jednocześnie code == 0 i data.bizCode == 0. Zobacz Ujednolicona struktura odpowiedzi.
Kody błędów API (code)
| code | Opis | Zalecenie |
|---|---|---|
| 0 | Sukces | — |
| 401 | Uwierzytelnianie nieudane | Konkretną przyczynę znajdziesz w tabeli poniżej |
| 429 | Too Many Requests | Zmniejsz częstotliwość wywołań i spróbuj ponownie; każde API przyjmuje do 10 żądań / sekundę |
Przyczyny błędu 401
| Komunikat | Znaczenie | Zalecenie |
|---|---|---|
| Missing required headers | Brak wymaganego nagłówka żądania | Sprawdź, czy obecne są wszystkie nagłówki z sekcji Wspólne nagłówki żądania |
| Invalid timestamp format | Nieprawidłowy format znacznika czasu | X-Timestamp musi być znacznikiem czasu w sekundach |
| Request timestamp expired | Znacznik czasu żądania wygasł | Zsynchronizuj zegar serwera i wyślij żądanie ponownie |
| Invalid nonce format | Nonce nie spełnia reguły formatu | Musi pasować do ^[A-Za-z0-9]{16,32}$ |
| Nonce already used or validation failed | Nonce został już użyty lub nie przeszedł weryfikacji | Używaj nowego losowego ciągu w każdym żądaniu; nigdy go nie powtarzaj |
| appId not found | appId nie istnieje | Sprawdź APP-ID |
| appId is disabled | appId został wyłączony | Skontaktuj się z pomocą techniczną |
| Signature calculation failed | Obliczenie podpisu nie powiodło się | Sprawdź implementację podpisu; zobacz Mechanizm podpisu |
| Signature verification failed | Weryfikacja podpisu nie powiodła się | Sprawdź kolejność łączenia ciągu do podpisania, czy path zawiera prefiks /open-apis oraz czy timestamp i nonce są zgodne z nagłówkami |
Biznesowe kody błędów (bizCode)
| bizCode | Opis |
|---|---|
| 0 | Sukces |
| 10000001 | Nieprawidłowe parametry |
| 10000003 | Zbyt wiele żądań. Odczekaj chwilę i spróbuj ponownie |
| 10000103 | Usługa systemowa działa nieprawidłowo, skontaktuj się z obsługą klienta |
| 100027001 | Nieprawidłowe parametry operacji na punktach |
| 100027003 | Niewystarczające saldo punktów |
| 100041003 | Zadanie modelowania przestrzennego nie istnieje |
| 100041004 | Nie znaleziono wyniku modelowania przestrzennego |
| 100041006 | Nie znaleziono przestrzeni |
| 100041010 | AppId nie ma uprawnień do modelowania przestrzennego |
| 100041016 | Status zadania [modelowanie], usunięcie jest niedozwolone |
| 100041017 | Zadania nie można anulować w jego obecnym statusie |
Diagnozowanie nieudanego modelowania
Gdy zadanie przejdzie w status Modelowanie nieudane (9), wywołaj Lista zadań ze stronicowaniem lub Szczegóły zadań i odczytaj errorCode oraz failedReason, aby ustalić przyczynę.
Te dwa pola przenoszą informacje o błędach z wnętrza potoku modelowania i używają innego zestawu wartości niż opisany wyżej bizCode. Gdy wywołanie API się powiedzie, ale modelowanie zadania zakończy się niepowodzeniem, bizCode nadal wynosi 0.