Các mã lỗi thường gặp
Mã lỗi chung thể hiện mã trạng thái HTTP trong phản hồi API khi yêu cầu API thất bại. Dưới đây là các mã lỗi thường gặp:
| Mã lỗi | Thông báo | Mô tả |
400 | Bad Request | Mã lỗi này xuất hiện khi yêu cầu của khách hàng không hợp lệ hoặc thiếu thông tin cần thiết. Thường do sai cú pháp trong URL, header, hoặc body của yêu cầu. |
401 | Unauthorized | Mã lỗi này xuất hiện khi người dùng chưa xác thực hoặc thông tin xác thực cung cấp không hợp lệ. Để truy cập tài nguyên yêu cầu, người dùng cần cung cấp thông tin đăng nhập hợp lệ (ví dụ: tên người dùng và mật khẩu) hoặc token xác thực. |
404 | Not Found | Mã lỗi này được trả về khi tài nguyên yêu cầu không tồn tại trên máy chủ. Ví dụ, URL yêu cầu không trỏ đến bất kỳ tài nguyên nào có sẵn. |
500 | Internal Server Error | Mã lỗi này xuất hiện khi có sự cố phía máy chủ, ví dụ như lỗi phần mềm hoặc cấu hình không đúng khiến máy chủ không thể xử lý yêu cầu. |
| 502 | Bad Gateway | Mã lỗi này xảy ra khi máy chủ gateway hoặc proxy nhận được phản hồi không hợp lệ từ máy chủ upstream (máy chủ gốc), thường là do vấn đề mạng hoặc cấu hình sai. |
| 504 | Gateway Timeout | Mã lỗi này xuất hiện khi máy chủ gateway hoặc proxy không nhận được phản hồi từ máy chủ upstream trong thời gian quy định. Điều này thường xảy ra khi máy chủ gốc gặp sự cố hoặc mạng bị gián đoạn. |