دليل تكامل API

ابدأ في 5 خطوات بسيطة

المصادقة

تتطلب جميع نقاط نهاية API المصادقة عبر مفتاح API الخاص بك. يمكنك تمرير المفتاح بأي من هذه الطرق:

أرسل رسالة WhatsApp إلى رقم هاتف أو مجموعة. توضع الرسائل في قائمة انتظار وتُسلَّم عند تشغيل تطبيق سطح المكتب.

POST https://onemessengerhub.com/api/whatsapp-session/send

المعاملات

مثال على الطلب

curl -X POST https://onemessengerhub.com/api/whatsapp-session/send \

  -H "X-API-Key: YOUR_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{"mobile": "1234567890", "message": "Hello!"}'

طلب GET بسيط (متصفح أو رابط)

https://onemessengerhub.com/api/whatsapp-session/send?key=YOUR_API_KEY&mobile=1234567890&message=Hello!

استجابة النجاح (201)

{

  "success": true,

  "message": "Message queued successfully",

  "data": {

    "message_id": 123,

    "recipient": "1234567890",

    "status": "pending"

  }

}

احفظ جهة اتصال أو أعد تسميتها في WhatsApp الخاص بك. توضع العملية في قائمة انتظار ويعالجها تطبيق سطح المكتب.

POST https://onemessengerhub.com/api/whatsapp-session/save-contact

المعاملات

مثال على الطلب

curl -X POST https://onemessengerhub.com/api/whatsapp-session/save-contact \

  -H "X-API-Key: YOUR_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{"contact_id": "1234567890", "name": "John Doe"}'

استجابة النجاح (201)

{

  "success": true,

  "message": "Contact save operation queued",

  "data": {

    "operation_id": 456,

    "contact_id": "[email protected]",

    "status": "pending"

  }

}

أزل جهة اتصال من WhatsApp الخاص بك. توضع العملية في قائمة انتظار ويعالجها تطبيق سطح المكتب.

POST https://onemessengerhub.com/api/whatsapp-session/remove-contact

المعاملات

مثال على الطلب

curl -X POST https://onemessengerhub.com/api/whatsapp-session/remove-contact \

  -H "X-API-Key: YOUR_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{"contact_id": "1234567890"}'

استجابة النجاح (201)

{

  "success": true,

  "message": "Contact remove operation queued",

  "data": {

    "operation_id": 789,

    "contact_id": "[email protected]",

    "status": "pending"

  }

}

معالجة الأخطاء

تستخدم واجهة API رموز حالة HTTP القياسية. إليك استجابات الأخطاء الشائعة:

خطأ المصادقة (401)

{

  "success": false,

  "message": "Invalid or inactive API key"

}

خطأ التحقق (422)

{

  "success": false,

  "message": "Validation failed",

  "errors": {

    "mobile": ["The mobile field is required when group id is not present."],

    "message": ["The message field is required."]

  }

}

ما يمكنك بناؤه

المزيد من واجهات API قريباً

نوسّع عروض واجهات API لدينا لتغطية المزيد من المنصات وحالات الاستخدام.