Kody statusu HTTP
Błędy HTTP są zwracane, gdy żądanie nie może być przetworzone na poziomie transportu.
| Kod statusu↕ | Znaczenie↕ |
|---|---|
| 400 | Zły argument / złe żądanie — żądanie zawiera nieprawidłowe dane wejściowe. |
| 401 | Brak autoryzacji — nie podano prawidłowych poświadczeń. |
| 404 | Nie znaleziono — żądany zasób nie istnieje. |
| 409 | Konflikt zasobów — żądanie powoduje konflikt z obecnym stanem zasobu. |
| 412 | Niezachowany warunek wstępny — wymagany warunek nie został spełniony przed przetwarzaniem. |
| 422 | Nieprzetwarzalna jednostka — treść żądania jest strukturalnie prawidłowa, ale zawiera nieprawidłowe wartości. |
| 429 | Ograniczenie szybkości — zbyt wiele żądań w krótkim okresie. Użyj wykładniczych opóźnień i ponownych prób. |
| 500 | Błąd wewnętrzny serwera — wystąpił nieoczekiwany błąd po stronie serwera. Spróbuj ponownie; skontaktuj się z pomocą techniczną, jeśli problem się powtarza. |
| 503 | Usługa niedostępna — usługa jest tymczasowo niedostępna. Spróbuj ponownie po krótkim opóźnieniu. |
| 504 | Limit czasu — serwer nie otrzymał odpowiedzi w czasie. Spróbuj ponownie wysłać żądanie. |
Format błędu GraphQL
Błędy na poziomie aplikacji są zwracane jako lista w polu errors treści odpowiedzi. Każdy błąd zawiera message, path operacji, która się nie powiodła, oraz obiekt extensions z typem błędu i identyfikatorem żądania.
1
{2
"errors": [3
{4
"message": "Description of the error",5
"path": [6
"landedCostCalculate"7
],8
"extensions": {9
"errorType": "BAD_REQUEST",10
"requestId": "req_abc123"11
}12
}13
]14
}Klasyfikacje błędów
Pole extensions.errorType wskazuje kategorię błędu i zalecaną akcję.
| Klasyfikacja↕ | Równoważnik HTTP↕ | Znaczenie↕ | Akcja↕ |
|---|---|---|---|
BAD_REQUEST | 400 | Nieprawidłowe dane wejściowe lub parametry żądania. | Napraw żądanie — sprawdź wymagane pola, formaty i wartości. |
NOT_FOUND | 404 | Przywoływany zasób nie istnieje. | Zweryfikuj identyfikatory, kody i domyślne konfiguracje. |
UNAVAILABLE | 503 | Żądana usługa lub opcja nie jest dostępna dla tej trasy. | Spróbuj innej metody, poziomu usługi lub destynacji. |
PERMISSION_DENIED | 401 / 403 | Błąd uwierzytelnienia lub autoryzacji. | Sprawdź poświadczenia i uprawnienia konta. |
FAILED_PRECONDITION | 412 | Wymagana konfiguracja lub warunek konfiguracji nie został spełniony. | Sprawdź ustawienia organizacji lub skontaktuj się z pomocą techniczną. |
INTERNAL | 500 | Nieoczekiwany błąd po stronie serwera. | Spróbuj ponownie wysłać żądanie; skontaktuj się z pomocą techniczną, jeśli problem się powtarza. |
UNKNOWN | 500 | Nieoczekiwany błąd bez dalszej klasyfikacji. | Zweryfikuj format żądania; skontaktuj się z pomocą techniczną, jeśli problem się powtarza. |
Błędy API
Zrozumienie i rozwiązywanie błędów zwracanych przez interfejs GraphQL API Zonos.
GraphQL
API Zonos zwraca dwa rodzaje błędów: kody statusu HTTP dla błędów na poziomie transportu oraz błędy GraphQL dla problemów na poziomie aplikacji. Większość błędów to błędy GraphQL, które zawierają klasyfikację w polu
extensionspomagającą w zidentyfikowaniu przyczyny i odpowiednego rozwiązania.