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: معنى كل خطأ وكيفية إصلاحه
تحمل كل استجابة من RESTful API قيمة رقمية باسم StatusCode. الرمز 0 يعني النجاح. استجابات الـ callback مختلفة: يجب أن يردّ خادمك دائمًا بـ {"status":"done"} مع HTTP 200.
| الرمز | الحالة | المعنى | ما يجب فعله |
|---|---|---|---|
| 0 | Success | اكتملت العملية. | لا شيء. |
| 1 | Invalid Request Data | نص JSON تالف أو يحتوي على قيم غير صالحة. | أرسل JSON خامًا بترميز UTF-8 مع الترويسة Content-Type: application/json. تحقق من القيم. |
| 2 | Invalid Service Tag ID | معامل الاستعلام stgid لا يطابق أي جهاز مسجل. | انسخ Service Tag ID مرة أخرى من حسابك في API Monitor. |
| 3 | Invalid Request | الطلب لا يتبع صيغة تلك العملية. | قارنه بنموذج الطلب الخاص بالعملية. |
| 4 | Invalid Encryption | تعذّر فك تشفير حمولة AES-256. | تحقق من مفتاح التشفير ومن ترميز Base64. |
| 5 | Device Offline | الجهاز المستهدف غير متصل بـ Cams الآن. | افحص صفحة Device Status. يوضع الأمر في الطابور ويُسلَّم عند عودة اتصال الجهاز. |
| 6 | Operation Timeout | لم يؤكد الجهاز استلام الأمر في الوقت المحدد. | تأكد أن الجهاز متصل ثم حاول مرة أخرى. |
| 7 | Invalid Auth Token | قيمة AuthToken لا تطابق المحددة للجهاز. | استخدم الرمز المكوّن من 32 حرفًا من API Monitor. |
| 8 | User Already Exists | جرت محاولة إضافة UserID موجود أصلًا على الجهاز. | حدّث المستخدم بدلًا من ذلك، أو احذفه أولًا. |
| 9 | User Not Found | الـ UserID غير موجود على الجهاز. | تحقق من الـ UserID. أضف المستخدم أولًا عند الحاجة. |
| 10 | Template Error | قالب البصمة الحيوية تالف أو بصيغة غير مدعومة. | تحقق من بيانات Base64 ومن Size وIndex الخاصين بالقالب. |
| 11 | Device Memory Full | بلغ الجهاز حدّه الأقصى من المستخدمين أو القوالب. | احذف المستخدمين أو القوالب التي لم تعد مطلوبة. |
| 13 | Invalid Security Key | مفتاح الأمان لا يطابق المفتاح في API Monitor. | استخدم المفتاح نفسه على الطرفين. |
| 15 | Feature Not Supported | طراز الجهاز هذا أو وضع الاتصال لا يدعم العملية. | تحقق من وضع الاتصال. وضعا DB Pull وFile Processing يدعمان دفع الحضور (attendance 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?