Kody odpowiedzi stanu

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.