Mô tả

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ỗiThông báoMô 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.

502Bad GatewayMã 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.
504Gateway TimeoutMã 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.