Machine translation. This page was translated by AI from the English article and has not been reviewed by a person yet. Read the English original
Developer
Mã trạng thái API: ý nghĩa từng lỗi và cách khắc phục
Mỗi phản hồi của RESTful API đều có một StatusCode dạng số. Mã 0 nghĩa là thành công. Phản hồi callback thì khác: máy chủ của bạn luôn trả lời {"status":"done"} với HTTP 200.
| Mã | Trạng thái | Ý nghĩa | Cần làm gì |
|---|---|---|---|
| 0 | Success | Thao tác đã hoàn tất. | Không cần làm gì. |
| 1 | Invalid Request Data | Phần thân JSON sai định dạng hoặc có giá trị không hợp lệ. | Gửi JSON thô theo UTF-8 với header Content-Type: application/json. Kiểm tra các giá trị. |
| 2 | Invalid Service Tag ID | Tham số truy vấn stgid không khớp với thiết bị nào đã đăng ký. | Sao chép lại Service Tag ID từ tài khoản API Monitor của bạn. |
| 3 | Invalid Request | Yêu cầu không theo định dạng của thao tác đó. | So sánh với yêu cầu mẫu của thao tác. |
| 4 | Invalid Encryption | Không giải mã được payload AES-256. | Kiểm tra khóa mã hóa và mã hóa Base64. |
| 5 | Device Offline | Thiết bị đích hiện không kết nối với Cams. | Kiểm tra trang Device Status. Lệnh được xếp hàng và sẽ gửi khi thiết bị kết nối lại. |
| 6 | Operation Timeout | Thiết bị không xác nhận lệnh kịp thời. | Kiểm tra thiết bị có trực tuyến không, rồi thử lại. |
| 7 | Invalid Auth Token | AuthToken không khớp với token đã đặt cho thiết bị. | Dùng token 32 ký tự từ API Monitor. |
| 8 | User Already Exists | Đã thử thêm một UserID vốn đã có trên thiết bị. | Hãy cập nhật người dùng, hoặc xóa người dùng trước. |
| 9 | User Not Found | UserID không có trên thiết bị. | Kiểm tra UserID. Thêm người dùng trước nếu cần. |
| 10 | Template Error | Mẫu sinh trắc học bị hỏng hoặc có định dạng không được hỗ trợ. | Kiểm tra dữ liệu Base64, Size và Index của mẫu. |
| 11 | Device Memory Full | Thiết bị đã đạt giới hạn người dùng hoặc mẫu. | Xóa các người dùng hoặc mẫu không còn cần thiết. |
| 13 | Invalid Security Key | Khóa bảo mật không khớp với khóa trong API Monitor. | Dùng cùng một khóa ở cả hai phía. |
| 15 | Feature Not Supported | Model thiết bị hoặc chế độ kết nối này không hỗ trợ thao tác. | Kiểm tra chế độ kết nối. Chế độ DB Pull và File Processing chỉ hỗ trợ đẩy dữ liệu chấm công, không hỗ trợ lệnh RESTful. |
| 999 | Unknown Error | Lỗi không mong đợi. | Liên hệ bộ phận hỗ trợ Cams và cung cấp OperationID. |
Mẹo
- Hãy tạo một OperationID duy nhất cho mỗi yêu cầu REST. Phản hồi sẽ lặp lại nó, giúp bạn đối chiếu yêu cầu và phản hồi.
- Lệnh REST mất khoảng 15 giây để đến thiết bị.
- Mã 12 và 14 không được sử dụng.
Liên quan: Callback URL không nhận được dữ liệu, Thêm hoặc xóa hàng loạt người dùng.
Cần trợ giúp? Hãy gửi email tới support@camsbiometrics.com kèm OperationID và StatusCode.
Was this article helpful?