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 Mô tả HTTP Ghi chú
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 về 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ệ (người bán, dịch vụ, vị trí không tìm thấy, cố gắng đặt một vị trí không hợp lệ, hủy một lượt đặt trước 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ệ, 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 Bị cấm Quyền bị từ chối/bị cấm (đã biết và từ chối phương thức gọi). Không được dùng phản hồi này cho các trường hợp từ chối do dùng hết một số tài nguyên (thay vào đó, hãy dùng Too Many Requests cho những lỗi đó). Không được sử dụng Forbidden nếu không thể xác định phương thức 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 Tình huống xung đột Thao tác bị huỷ, thường do một vấn đề đồng thời, chẳng hạn như lỗi kiểm tra trình tự tuần 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 cho mỗi người dùng hoặc có thể toàn bộ hệ thống tệp đã hết dung lượng.
499 Ứng dụng đã đóng yêu cầu Thao tác đã bị huỷ, thường là do người 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ố bất biến mà 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 được triển khai Thao tác này chưa đượ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 và có thể khắc phục được bằng cách thử lại thông qua thời gian đợi.
504 Hết thời gian chờ cổng Đã hết thời hạn trước khi thao tác này 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ị chậm trễ đủ lâu để hết thời 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 áp dụng.