W odpowiedziach HTTP mogą być zwracane te kody stanu.
| Kod HTTP | Opis HTTP | Uwagi |
|---|---|---|
| 2xx | OK | Nie jest błędem; zwracany po zakończeniu operacji. Należy go też używać w przypadku błędów logiki biznesowej (np.gdy pole booking_failure w CreateBookingResponse jest wypełnione). |
| 400 | Nieprawidłowe żądanie | Nieprawidłowe żądanie lub nieprawidłowe argumenty (nie znaleziono sprzedawcy, usługi lub przedziału czasu, próba rezerwacji nieprawidłowego przedziału czasu, anulowanie rezerwacji, która nigdy nie istniała). |
| 401 | Brak autoryzacji | Nieautoryzowany (nieprawidłowe dane logowania, spróbuj ponownie zalogować się). Żądanie nie ma prawidłowych danych uwierzytelniających dla tej operacji. |
| 403 | Zabroniono | Odmowa dostępu/zakaz (dzwoniący jest znany i odrzucony). Tego
komunikatu nie należy używać w przypadku odrzuceń spowodowanych wyczerpaniem zasobu (w przypadku takich błędów należy użyć kodu Too Many Requests).
Nie można używać wartości Forbidden, jeśli nie można zidentyfikować wywołującego (w przypadku takich błędów należy użyć wartości Unauthorized). |
| 404 | Nie znaleziono | Nie znaleziono (nie znaleziono zasobu, nieprawidłowy URL, w tym nieprawidłowe wywołania RPC) |
| 409 | Konflikt | Operacja została przerwana, najczęściej z powodu problemu równoczesności, np. w przypadku nieudanej kontroli sekwencera lub przerwanej transakcji. |
| 429 | Zbyt wiele zgłoszeń | Niektóre zasoby zostały wyczerpane, np. limit dla poszczególnych użytkowników lub cały system plików nie ma już miejsca. |
| 499 | Zamknij żądanie klienta | Operacja została anulowana, zwykle przez element wywołujący. |
| 500 | Wewnętrzny błąd serwera | Błędy wewnętrzne. Oznacza to, że pewne niezmienniki oczekiwane przez system bazowy zostały uszkodzone. Ten kod błędu jest zarezerwowany dla poważnych błędów. |
| 501 | Nie wdrożono | Operacja nie jest wdrożona lub nie jest obsługiwana/włączona w tej usłudze. |
| 503 | Usługa jest niedostępna | Usługa jest obecnie niedostępna. Jest to najczęściej stan przejściowy, który można rozwiązać, ponawiając próbę z większym odstępem. |
| 504 | Przekroczony czas oczekiwania bramy | Termin upłynął przed wykonaniem operacji. W przypadku operacji, które zmieniają stan systemu, ten błąd może zostać zwrócony nawet wówczas, 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ął. |
Czasami może być kilka kodów błędów. Usługi powinny zwracać najbardziej specyficzny kod błędu.