Support Hub/API & Integrations/رموز حالة API: معنى كل خطأ وكيفية إصلاحه
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.

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