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 extensions pomagającą w zidentyfikowaniu przyczyny i odpowiednego rozwiązania.
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.
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.
Błędy API
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.Kody statusu HTTP
Błędy HTTP są zwracane, gdy żądanie nie może być przetworzone na poziomie transportu.
Format błędu GraphQL
Błędy na poziomie aplikacji są zwracane jako lista w polu
errorstreści odpowiedzi. Każdy błąd zawieramessage,pathoperacji, która się nie powiodła, oraz obiektextensionsz typem błędu i identyfikatorem żądania.{"errors": [{"message": "Description of the error","path": ["landedCostCalculate"],"extensions": {"errorType": "BAD_REQUEST","requestId": "req_abc123"}}]}Klasyfikacje błędów
Pole
extensions.errorTypewskazuje kategorię błędu i zalecaną akcję.BAD_REQUESTNOT_FOUNDUNAVAILABLEPERMISSION_DENIEDFAILED_PRECONDITIONINTERNALUNKNOWNCzy ta strona była pomocna?