نظرة عامة
توفر 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 | خطأ داخلي بالخادم | أعد المحاولة، ثم تواصل مع الدعم إذا استمرت المشكلة. |