Support Hub/API & Integrations/Mã trạng thái API: ý nghĩa từng lỗi và cách khắc phục
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ĩaCần làm gì
0SuccessThao tác đã hoàn tất.Không cần làm gì.
1Invalid Request DataPhầ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ị.
2Invalid Service Tag IDTham 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.
3Invalid RequestYê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.
4Invalid EncryptionKhông giải mã được payload AES-256.Kiểm tra khóa mã hóa và mã hóa Base64.
5Device OfflineThiế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.
6Operation TimeoutThiế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.
7Invalid Auth TokenAuthToken không khớp với token đã đặt cho thiết bị.Dùng token 32 ký tự từ API Monitor.
8User 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.
9User Not FoundUserID không có trên thiết bị.Kiểm tra UserID. Thêm người dùng trước nếu cần.
10Template ErrorMẫ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.
11Device Memory FullThiế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.
13Invalid Security KeyKhó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.
15Feature Not SupportedModel 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.
999Unknown ErrorLỗ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?