Poniższe kody stanu mogą być zwracane w odpowiedziach HTTP.
Kod HTTP | Opis HTTP | Uwagi |
---|---|---|
2xx | OK | To nie jest błąd; zwrócona w przypadku powodzenia. Tej opcji należy też używać w przypadku błędów logiki biznesowej (np.pole booking_failure w CreateBookingResponse jest wypełnione). |
400 | Nieprawidłowe żądanie | Nieprawidłowe żądanie/nieprawidłowe argumenty (sprzedawca, usługa, nie znaleziono przedziału, próba rezerwacji nieprawidłowego przedziału, anulowanie rezerwacji, która nigdy nie istniała). |
401 | Brak autoryzacji | Brak uwierzytelnienia (nieprawidłowe dane logowania, ponów próbę logowania). Żądanie nie ma prawidłowych danych uwierzytelniających dla tej operacji. |
403 | Zabroniono | Odmowa/brak uprawnień (rozmówca jest znany i odrzucony). Tej odpowiedzi nie można używać w przypadku odrzucenia z powodu wyczerpania zasobów (w przypadku tych błędów użyj Too Many Requests ).
Nie wolno używać Forbidden , jeśli nie można zidentyfikować elementu wywołującego (w przypadku tych błędów zamiast tego użyj Unauthorized ). |
404 | Nie znaleziono | Nie znaleziono (nie znaleziono zasobu, nieprawidłowy adres URL, w tym nieprawidłowe wywołania RPC) |
409 | Konflikt | Operacja została przerwana, zwykle z powodu problemu równoczesności, takiego jak błąd sprawdzania sekwencera lub przerwanie transakcji. |
429 | Zbyt wiele zgłoszeń | Wyczerpał się jakiś zasób – być może limit na użytkownika albo w całym systemie plików zabrakło miejsca. |
499 | Żądanie zamknięcia klienta | Operacja została anulowana, zwykle przez element wywołujący. |
500 | Wewnętrzny błąd serwera | Błędy wewnętrzne. Oznacza to, że niektóre niezmienniki oczekiwane przez system bazowy zostały uszkodzone. Ten kod błędu jest zarezerwowany na poważne błędy. |
501 | Nie wdrożono | Operacja nie jest zaimplementowana lub nie jest obsługiwana/włączona w tej usłudze. |
503 | Usługa niedostępna | Usługa jest obecnie niedostępna. Najprawdopodobniej jest to stan przejściowy, który można skorygować, ponownie próbując wykonać ponawianie. |
504 | Przekroczenie limitu czasu bramy | Termin minął przed zakończeniem operacji. W przypadku operacji, które zmieniają stan systemu, ten błąd może zostać zwrócony nawet wtedy, gdy operacja zakończyła się pomyślnie. Na przykład pomyślna odpowiedź serwera mogła być tak opóźniona, że termin upłynął. |
Może się zdarzyć, że pojawi się kilka kodów błędów. Usługi powinny zwracać najbardziej konkretny kod błędu, który występuje.