Các mã trạng thái sau đây có thể được trả về trong phản hồi HTTP.
| Mã HTTP | Mô tả trong HTTP | Lưu ý |
|---|---|---|
| 2xx | OK | Không phải lỗi; trả về khi thành công. Bạn cũng nên sử dụng thuộc tính này cho các lỗi logic kinh doanh (ví dụ: booking_failure trong CreateBookingResponse được điền sẵn) |
| 400 | Yêu cầu không hợp lệ | Yêu cầu không hợp lệ/Đối số không hợp lệ (không tìm thấy người bán, dịch vụ, vị trí, cố gắng đặt chỗ không hợp lệ, hủy yêu cầu đặt phòng chưa từng tồn tại). |
| 401 | Không được phép | Chưa được xác thực (thông tin xác thực không hợp lệ, thử đăng nhập lại). Yêu cầu không có thông tin xác thực hợp lệ cho thao tác này. |
| 403 | Cấm | Quyền bị từ chối/bị cấm (người gọi đã biết và bị từ chối). Bạn không được dùng thông tin phản hồi này cho các trường hợp từ chối do cạn kiệt tài nguyên (thay vào đó, hãy sử dụng Too Many Requests cho các lỗi đó).
Không được sử dụng Forbidden nếu không thể nhận dạng người gọi (thay vào đó, hãy sử dụng Unauthorized cho những lỗi đó). |
| 404 | Không tìm thấy | Không tìm thấy (Không tìm thấy tài nguyên, url không hợp lệ, bao gồm cả RPC không hợp lệ) |
| 409 | Xung đột | Thao tác này đã bị huỷ, thường là do vấn đề đồng thời, chẳng hạn như lỗi kiểm tra trình tự hoặc huỷ giao dịch. |
| 429 | Quá nhiều yêu cầu | Một số tài nguyên đã hết, có thể là định mức cho mỗi người dùng hoặc có thể là toàn bộ hệ thống tệp đã hết dung lượng. |
| 499 | Yêu cầu đã đóng của ứng dụng | Thao tác này đã bị huỷ, thường là do người gọi thực hiện. |
| 500 | Lỗi máy chủ nội bộ | Lỗi nội bộ. Điều này có nghĩa là một số biến thể dự kiến do hệ thống cơ bản dự kiến đã bị hỏng. Mã lỗi này dành riêng cho các lỗi nghiêm trọng. |
| 501 | Chưa triển khai | Thao tác này không được triển khai hoặc không được hỗ trợ/bật trong dịch vụ này. |
| 503 | Dịch vụ không khả dụng | Dịch vụ này hiện không dùng được. Đây rất có thể là một tình trạng tạm thời, có thể khắc phục bằng cách thử lại bằng một khoảng thời gian đợi. |
| 504 | Hết thời gian chờ của cổng | Hạn chót đã hết hạn trước khi thao tác có thể hoàn tất. Đối với các thao tác thay đổi trạng thái của hệ thống, lỗi này có thể được trả về ngay cả khi thao tác đã hoàn tất thành công. Ví dụ: một phản hồi thành công từ máy chủ có thể đã bị trì hoãn đủ lâu để thời hạn hết hạn. |
Đôi khi, có thể áp dụng nhiều mã lỗi. Dịch vụ sẽ trả về mã lỗi cụ thể nhất được áp dụng.