Translated from the English article and reviewed by a person. Read the English original
Fix
عنوان Callback URL لا يستقبل البيانات: قائمة فحص
إذا لم تصل البصمات إلى عنوان callback لديك، فأجرِ هذه الفحوصات بالترتيب.
- هل يصل الجهاز إلى Cams؟ افتح صفحة Device Status. إذا كان الجهاز غير متصل، راجع Why a device shows offline.
- هل العنوان صحيح؟ تحقق من عنوان callback المحفوظ في حسابك على API Monitor.
- هل يردّ خادمك بشكل صحيح؟ ردّ دائمًا بـ
{"status":"done"}مع حالة HTTP 200، حتى لو فشلت معالجتك الخاصة. أجرِ العمل الثقيل لاحقًا في طابور، حتى لا يبقى Cams منتظرًا. - هل يمكن الوصول إلى نقطة النهاية من الإنترنت؟ استخدم المنفذ 80 (HTTP) أو 443 (HTTPS) في بيئة الإنتاج. المنفذ 8123 للاختبار فقط. اسمح بهذه المنافذ في جدار الحماية.
- هل إعداد HTTPS سليم؟ HTTPS مع شهادة SSL صالحة على المنفذ 443 مدعوم وموصى به. تأكد أن الشهادة تتجدد دون إعادة تشغيل الخادم.
- هل تقرأ المحتوى كـ JSON خام؟ الطلبات هي JSON خام بترميز UTF-8، وليست حقول نموذج.
- هل فحص AuthToken صحيح؟ يحمل كل callback قيمة AuthToken. قارنها بالرمز المحدد في API Monitor وارفض أي عدم تطابق. تأكد أنك لا ترفض طلبات سليمة بسبب المقارنة بالرمز الخاطئ.
- هل التشفير مفعّل؟ إذا كان Security Key محددًا في API Monitor، فإن الحمولات مشفّرة. يجب أن يفك خادمك تشفيرها بالمفتاح نفسه. وإذا لم تقصد استخدام التشفير، فأزل المفتاح.
- هل توقف التسليم مؤقتًا؟ إذا ردّ خادمك باستجابة غير متوقعة، تتم محاولة التسليم حتى ثلاث مرات ثم يتوقف مؤقتًا مع محاولة جديدة كل ثلاث ساعات. أصلح الخادم وأعد تشغيل الطابور من صفحة Device Status. راجع Punches not transmitting or queuing up.
اختبره
- أرسل طلب POST تجريبيًا إلى عنوانك باستخدام Postman أو cURL.
- للاختبار من حاسوبك الشخصي، استخدم نفقًا (tunnel) مثل ngrok. راجع Testing callback URLs from your local environment.
- لبناء المستقبِل، راجع Building a biometric callback receiver.
الأحداث التي تعذّر تسليمها تُحفظ وتُرسل عند عودة خادمك. راجع Punches made while a device was offline.
ما زالت المشكلة قائمة؟ راسلنا على support@camsbiometrics.com مع الرقم التسلسلي للجهاز ووصف موجز للمشكلة.
Was this article helpful?