دليل المطور الشامل

🔑 متطلبات البداية

قبل البدء، ستحتاج إلى "مفتاح الوصول" (API Key) الخاص بك. يمكنك العثور عليه في لوحة التحكم. يجب تضمين هذا المفتاح في كل طلب ترسلُه إلى نظامنا.

المرحلة الأولى: طلب الكود

عندما يطلب المستخدم التحقق في تطبيقك، قم بإرسال طلب إلى النظام لتوليد كود فريد له. هذا الكود هو ما سيرسله المستخدم إلينا لاحقاً.

curl -X POST https://api.yourdomain.com/api/generate-code \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+201012345678"}'

المرحلة الثانية: تحرك المستخدم

اطلب من المستخدم إرسال الكود الذي ظهر له إلى رقم بوت الواتساب الخاص بنا. بمجرد وصول الرسالة، سيقوم النظام بتوثيق هذا الرقم تلقائياً.

المرحلة الثالثة: التحقق من الحالة

بعد بضع ثوانٍ من إرسال المستخدم للكود، قم بسؤال النظام: "هل قام صاحب هذا الرقم بالتحقق؟".

curl -X GET "https://api.yourdomain.com/api/check-status?phone=+201012345678" \
  -H "Authorization: Bearer YOUR_API_KEY"

الحالات المتوقعة (Status Values):

• verified: تم استلام الكود بنجاح والرقم موثق.
• pending: لم يتم استلام الكود بعد من هذا الرقم.
• expired: انتهت صلاحية الطلب (بعد 5 دقائق).

⚠️ رموز الأخطاء الشائعة