W odpowiedziach HTTP można zwrócić te kody stanu.
| Kod HTTP | Opis HTTP | Uwagi |
|---|---|---|
| 2xx | OK | To nie błąd, a powodzenie zostało zwrócone. Tego uprawnienia należy też używać w przypadku błędów logiki biznesowej (np. wypełniona właściwość booking_failure w CreateBookingResponse) |
| 400 | Nieprawidłowe żądanie | Nieprawidłowe żądanie/nieprawidłowe argumenty (sprzedawca, usługa, nie znaleziono boksu, próba zarezerwowania nieprawidłowego boksu, anulowanie rezerwacji, która nigdy nie istniała). |
| 401 | Brak autoryzacji | Nieuwierzytelnione (nieprawidłowe dane logowania, ponów próbę logowania). Żądanie nie ma prawidłowych danych uwierzytelniających dla tej operacji. |
| 403 | Zabroniono | Odmowa/zezwolenie (użytkownik dzwoniący jest znany i odrzucony). Tej odpowiedzi nie można używać w przypadku odrzucenia z powodu wyczerpania niektórych zasobów (w przypadku tych błędów użyj Too Many Requests).
Jeśli nie można zidentyfikować wywołującego, nie można użyć Forbidden (w przypadku tych błędów użyj Unauthorized). |
| 404 | Nie znaleziono | Nie znaleziono (nie znaleziono zasobu, nieprawidłowy URL, w tym nieprawidłowe RPC) |
| 409 | Konflikt | Operacja została przerwana, najczęściej z powodu problemu równoczesności, np. w przypadku niepowodzenia kontroli sekwencera lub przerwania transakcji. |
| 429 | Zbyt wiele zgłoszeń | Jeden zasób został wyczerpany, być może limit na użytkownika lub cały system plików nie ma już miejsca. |
| 499 | Żądanie zamknięcia klienta | Operacja została anulowana, zwykle przez rozmówcę. |
| 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 zaimplementowano | Operacja nie jest wdrożona lub nie jest obsługiwana w tej usłudze. |
| 503 | Usługa 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ę ponowienia. |
| 504 | Przekroczony czas 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 obowiązuje kilka kodów błędów. Usługi powinny zwracać najbardziej dokładny kod błędu.