دليل API
توثيق Yexa Pro API
واجهة برمجية لإرسال OTP عبر واتساب وإرسال الرسائل النصية — بدون تعقيد.
نظرة عامة
يوفّر Yexa Pro API واجهتين رئيسيتين: إرسال والتحقق من OTP عبر واتساب (بدون توكن)، وإرسال رسائل نصية من حسابك (يتطلب Bearer Token).
1أنشئ حساباً على Yexa Pro واربط رقم واتساب من لوحة التحكم
2لـ OTP: استدعِ /otp/send ثم /otp/verify — لا يحتاج توكن
3للرسائل: سجّل الدخول واحصل على Bearer Token
4أرسل رسالة نصية عبر POST /conversations/{id}/messages
المصادقة
مطلوبة فقط لإرسال الرسائل. نقاط OTP عامة ولا تحتاج توكن.
Header المطلوب
Authorization: Bearer {your_api_token}
Content-Type: application/jsonاحصل على التوكن بتسجيل الدخول بحساب Yexa Pro:
مثال cURL
curl -X POST https://api.yexa.pro/api/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"admin@yexa.pro","password":"your_password"}'WhatsApp OTP
عام — بدون توكنأرسل كود تحقق مكوّناً من 6 أرقام عبر واتساب، ثم تحقّق منه. لا يحتاج Bearer Token — فقط رقم الهاتف بصيغة E.164 أو محلية (مثل 0501234567).
إعداد OTP
1لا حاجة لتوكن API — النقاط عامة
2يستخدم قالب yexa_otp المعتمد من Meta (مُدار من المنصة)
3صلاحية الكود: 10 دقائق · Cooldown إعادة الإرسال: 60 ثانية
مسار التحقق
1أرسل رقم الهاتف → POST /auth/whatsapp/otp/send
↓
2يستلم المستخدم 6 أرقام عبر واتساب
↓
3تحقق من الكود → POST /auth/whatsapp/otp/verify
مثال إرسال OTP
curl -X POST https://api.yexa.pro/api/auth/whatsapp/otp/send \
-H "Content-Type: application/json" \
-d '{"phone":"966501234567"}'مثال التحقق من OTP
curl -X POST https://api.yexa.pro/api/auth/whatsapp/otp/verify \
-H "Content-Type: application/json" \
-d '{"phone":"966501234567","code":"042891"}'إرسال الرسائل
يتطلب Bearer Token. معرّف المحادثة (conversation ID) متاح من لوحة التحكم.
مثال إرسال رسالة نصية
curl -X POST https://api.yexa.pro/api/conversations/1/messages \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"type":"text","content":"مرحباً! سنساعدك الآن."}'