اختبار عناوين Callback الخاصة بـ Cams محلياً باستخدام ngrok
قبل نقل التكامل الخاص بك إلى بيئة الإنتاج، يمكنك اختبار استدعاءات Cams API مباشرةً على جهاز التطوير الخاص بك باستخدام أداة النفق (Tunneling). يرشدك هذا الدليل خلال إعداد خطوة بخطوة.
لماذا تحتاج إلى نفق
تنبثق طلبات Callback والـ webhook من منصة Cams عبر الإنترنت. لا يمكن للتطبيق المحلي الذي يعمل على جهازك استقبال هذه الطلبات مباشرةً لأنه يقع خلف جدار حماية أو شبكة NAT.
تنشئ خدمة النفق نقطة نهاية عامة آمنة تعيد توجيه الطلبات الواردة إلى التطبيق المحلي الخاص بك.
الفوائد
- اختبار استدعاءات Callback قبل النشر
- تصحيح حمولات webhook في الوقت الفعلي
- التحقق من معالجة الطلبات محلياً
- تقليل وقت التطوير والنشر
أدوات النفق الموصى بها

إعداد ngrok (موصى به)
التثبيت
- قم بزيارة https://ngrok.com
- قم بتنزيل الإصدار المناسب لنظام التشغيل الخاص بك.
- استخرج الملف التنفيذي وثبّته.
- أنشئ حساباً مجانياً (اختياري ولكنه موصى به).
- أنشئ AuthToken.
- قم بتهيئة AuthToken الخاص بك.
ngrok config add-authtoken YOUR_AUTHTOKEN
بدء تشغيل النفق
إذا كان ngrok مُهيّأً بالفعل:
ngrok http 3000
استبدل 3000 بمنفذ تطبيقك.
مثال على المخرجات
Forwarding https://abc123.ngrok-free.app -> http://localhost:3000
أصبح تطبيقك الآن متاحاً عبر عنوان HTTPS العام.
بديل: استخدام أداة اختبار Callback الخاصة بـ Cams
يمكنك أيضاً استخدام أداة اختبار Callback التي توفرها Cams.
- قم بتثبيت الأداة وفك ضغطها باستخدام الرابط التالي.
https://developer.camsbiometrics.com/setup/ngrok-helper-kit.rar - قم بتعديل ملف
app.properties. - قم بالإعداد:
ngrok.auth.token=
ngrok.tunnel.url= - قم بالتشغيل:
check_ngrok.bat
ستقوم الأداة تلقائياً بإنشاء النفق وتبسيط اختبار Callback المحلي.
إعداد تكامل Callback
الخطوة 1: ابدأ تشغيل تطبيقك المحلي
الخطوة 2: ابدأ تشغيل النفق
الخطوة 3: اختبر Callback
شغّل حدث اختبار نموذجياً وتحقق مما يلي:
- يستقبل تطبيقك طلب Callback.
- تتم معالجة حمولات الطلبات بنجاح.
- لا تظهر أي أخطاء في سجلات التطبيق.
- تكون الطلبات مرئية في لوحة معلومات النفق.
أفضل الممارسات
- استخدم عناوين Callback من نوع HTTPS كلما أمكن ذلك.
- أبقِ النفق نشطاً أثناء الاختبار.
- راجع سجلات التطبيق للتحقق من صحة الطلبات.
- تحقق من أن نقطة النهاية الخاصة بك تُرجع رموز استجابة HTTP المتوقعة.
- اختبر سيناريوهات معالجة الأخطاء قبل الانتقال إلى الإنتاج.
ملاحظات مهمة
- تتغير عناوين ngrok المجانية في كل مرة يُعاد فيها تشغيل النفق.
- تدعم خطط ngrok المدفوعة النطاقات المحجوزة والنطاقات الفرعية المخصصة.
- يجب استخدام الأنفاق المؤقتة للتطوير والاختبار فقط.
الخاتمة
يُعد كشف خادمك المحلي من خلال خدمة نفق أسرع طريقة لاختبار عنوان Callback الخاص بك قبل نشر تطبيقك. سواء استخدمت ngrok أو Cloudflare Tunnel أو localhost.run، تتيح لك هذه العملية استقبال طلبات Callback في الوقت الفعلي والتحقق من تكاملك في بيئة تطوير محلية.
سيساعد اتباع الخطوات أعلاه على ضمان انتقال سلس من التطوير إلى النشر في بيئة الإنتاج.