Mã trạng thái HTTP

Các mã trạng thái sau đây có thể được trả về trong phản hồi HTTP.

Mã HTTP Nội dung mô tả HTTP Ghi chú
2xx OK Không phải lỗi; được trả về khi thành công. Bạn cũng nên sử dụng phương thức này cho các lỗi logic nghiệp vụ (ví dụ: booking_failure trong CreateBookingResponse được điền sẵn)
400 Yêu cầu lỗi 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ụ, khung giờ, đang cố gắng đặt khung giờ không hợp lệ, huỷ một lượt đặt chỗ chưa từng tồn tại).
401 Không được cho phép Chưa xác thực (thông tin xác thực không hợp lệ, hãy 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.
403 Cấm Quyền bị từ chối/bị cấm (phương thức gọi được xác định và bị từ chối). Bạn không được sử dụng phản hồi này cho các trường hợp từ chối do sử dụng hết một số tài nguyên (hãy sử dụng Too Many Requests cho các lỗi đó). Không được sử dụng Forbidden nếu không xác định được phương thức gọi (hãy sử dụng Unauthorized cho các 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 Tình huống xung đột Thao tác đã 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à hạn mức trên mỗi người dùng hoặc có thể 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 đã bị huỷ, thường là do phương thức gọi.
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ố hằng số không đổi mà hệ thống cơ bản dự kiến đã bị phá vỡ. Mã lỗi này được 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 có thể là một điều kiện tạm thời, có thể được khắc phục bằng cách thử lại với thời gian đợi.
504 Hết thời gian chờ của cổng Thời hạn đã hết 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ụ: 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ụ phải trả về mã lỗi cụ thể nhất có thể áp dụng.