توثيق الربط المبرمج (API)
دليل المطورين لربط الأنظمة الخارجية مع منصة whatz.live وإرسال الرسائل برمجياً.
المصادقة (Authentication)
تتطلب جميع الطلبات تمرير مفاتيح المصادقة الخاصة بحسابك في الترويسة (Headers).
X-Header-App-Id: YOUR_APP_ID
X-Header-Authorization: YOUR_TOKEN
ملاحظة: يمكنك الحصول على المفاتيح الخاصة بك من لوحة التحكم > الإعدادات > الربط المبرمج.
إرسال رسالة (Send Message)
إرسال رسالة نصية أو وسائط إلى جهة اتصال.
POST
https://whatz.live/api/v1/send-messageجسم الطلب (Body Params)
| Parameter | Type | Required | Description |
|---|---|---|---|
| phone | string | Yes | Recipient's phone number in international format (e.g. 966500000000) |
| body | string | Conditional | Text message body (Required if media_src is not provided) |
| media_src | string | Optional | Direct URL to media file (Image) |
cURL Example
curl -X POST https://whatz.live/api/v1/send-message \
-H "X-Header-App-Id: YOUR_APP_ID" \
-H "X-Header-Authorization: YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"phone": "966500000000",
"body": "مرحبا بك في متجرنا"
}'استجابة ناجحة (Success Response)
{
"success": true,
"message_id": "wamid.HBgMOTY2...",
"status": "sent"
}