توثيق المطورين

Whatse API

مرجع عملي لبناء التكاملات مع Whatse. الأمثلة أدناه توضيحية للواجهة، ويجب اعتماد نقاط النهاية وطرق المصادقة والحدود الفعلية قبل نشر التوثيق الإنتاجي.

نظرة عامة

توفر Whatse واجهة REST تساعدك على ربط تطبيقك بتدفقات التواصل عبر واتساب باستخدام طلبات HTTP وبنية JSON واضحة.

ملاحظة: الأمثلة التالية مخصصة لتصميم الموقع. قبل الإطلاق، استبدلها بالقيم الإنتاجية الفعلية المعتمدة من Backend الخاص بـWhatse.

المصادقة

أرسل مفتاح API ضمن ترويسة Authorization في كل طلب يتطلب مصادقة.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

إرسال رسالة نصية

POST /api/v1/messages/send
{
  "to": "+973XXXXXXXX",
  "type": "text",
  "message": "Hello from Whatse"
}

رسائل الوسائط

POST /api/v1/messages/media

استخدم رابط الوسائط أو آلية الرفع التي يدعمها حسابك وفق مواصفات التكامل الفعلية.

{
  "to": "+973XXXXXXXX",
  "media_url": "https://example.com/file.jpg",
  "caption": "Your order is ready"
}

Webhooks

هيّئ عنوان HTTPS آمناً لاستقبال الأحداث التي ترسلها Whatse، ثم اربطها بمنطق المعالجة داخل نظامك.

{
  "event": "message.received",
  "message_id": "msg_123",
  "from": "+973XXXXXXXX"
}

رموز الأخطاء

الكودالمعنىالإجراء المقترح
400طلب غير صالحراجع الحقول والقيم المطلوبة.
401غير مصرحتحقق من مفتاح API وبيانات المصادقة.
429تجاوز حد الطلباتخفّف معدل الإرسال وأعد المحاولة وفق سياسة الانتظار.
500خطأ داخلي بالخادمأعد المحاولة، ثم تواصل مع الدعم إذا استمرت المشكلة.