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
API Status Codes: ข้อผิดพลาดแต่ละรหัสและวิธีแก้ไข
ทุกการตอบกลับของ RESTful API มี StatusCode เป็นตัวเลข รหัส 0 หมายถึงสำเร็จ การตอบกลับของ callback ต่างออกไป: เซิร์ฟเวอร์ของคุณต้องตอบ {"status":"done"} พร้อม HTTP 200 เสมอ
| Code | Status | ความหมาย | สิ่งที่ควรทำ |
|---|---|---|---|
| 0 | Success | การดำเนินการเสร็จสมบูรณ์ | ไม่ต้องทำอะไร |
| 1 | Invalid Request Data | JSON body ผิดรูปแบบหรือมีค่าที่ไม่ถูกต้อง | ส่ง raw JSON เป็น UTF-8 พร้อม header Content-Type: application/json และตรวจสอบค่า |
| 2 | Invalid Service Tag ID | พารามิเตอร์ query stgid ไม่ตรงกับอุปกรณ์ที่ลงทะเบียนไว้ | คัดลอก Service Tag ID จากบัญชี API Monitor ของคุณอีกครั้ง |
| 3 | Invalid Request | คำขอไม่เป็นไปตามรูปแบบของการดำเนินการนั้น | เปรียบเทียบกับตัวอย่างคำขอของการดำเนินการนั้น |
| 4 | Invalid Encryption | ถอดรหัส payload AES-256 ไม่ได้ | ตรวจสอบคีย์เข้ารหัสและการเข้ารหัส Base64 |
| 5 | Device Offline | อุปกรณ์เป้าหมายไม่ได้เชื่อมต่อกับ Cams ในขณะนี้ | ตรวจสอบหน้า Device Status คำสั่งจะถูกเข้าคิวและส่งเมื่ออุปกรณ์เชื่อมต่อใหม่ |
| 6 | Operation Timeout | อุปกรณ์ไม่ตอบรับคำสั่งภายในเวลาที่กำหนด | ตรวจสอบว่าอุปกรณ์ออนไลน์ แล้วลองอีกครั้ง |
| 7 | Invalid Auth Token | AuthToken ไม่ตรงกับที่ตั้งไว้สำหรับอุปกรณ์ | ใช้ token 32 ตัวอักษรจาก API Monitor |
| 8 | User Already Exists | พยายามเพิ่ม UserID ที่มีอยู่บนอุปกรณ์แล้ว | อัปเดตผู้ใช้แทน หรือลบผู้ใช้ก่อน |
| 9 | User Not Found | ไม่มี UserID นี้บนอุปกรณ์ | ตรวจสอบ UserID หากจำเป็นให้เพิ่มผู้ใช้ก่อน |
| 10 | Template Error | biometric template เสียหายหรือเป็นรูปแบบที่ไม่รองรับ | ตรวจสอบข้อมูล Base64, Size และ Index ของ template |
| 11 | Device Memory Full | อุปกรณ์ถึงขีดจำกัดจำนวนผู้ใช้หรือ template | ลบผู้ใช้หรือ template ที่ไม่ใช้แล้ว |
| 13 | Invalid Security Key | security key ไม่ตรงกับที่อยู่ใน API Monitor | ใช้คีย์เดียวกันทั้งสองฝั่ง |
| 15 | Feature Not Supported | รุ่นอุปกรณ์หรือโหมดการเชื่อมต่อนี้ไม่รองรับการดำเนินการนี้ | ตรวจสอบโหมดการเชื่อมต่อ โหมด DB Pull และ File Processing รองรับเฉพาะการ push ข้อมูลเวลา ไม่รองรับคำสั่ง RESTful |
| 999 | Unknown Error | ข้อผิดพลาดที่ไม่คาดคิด | ติดต่อฝ่ายสนับสนุนของ Cams และแจ้ง OperationID |
เคล็ดลับ
- สร้าง OperationID ที่ไม่ซ้ำสำหรับแต่ละคำขอ REST การตอบกลับจะส่งค่านี้กลับมา คุณจึงจับคู่คำขอกับการตอบกลับได้
- คำสั่ง REST ใช้เวลาประมาณ 15 วินาทีในการถึงอุปกรณ์
- ไม่มีการใช้รหัส 12 และ 14
ที่เกี่ยวข้อง: Callback URL not receiving data, Add or delete users in bulk
ต้องการความช่วยเหลือ? ส่งอีเมลถึง support@camsbiometrics.com พร้อม OperationID และ StatusCode
Was this article helpful?