بوابة المطورين (Developer Portal)
واجهة API احترافية لدمج خدماتنا في تطبيقاتك ومتاجرك الإلكترونية.
API v2.1 — نشط
12,480
طلب API (اليوم)99.7%
نسبة النجاح42ms
متوسط زمن الاستجابةTLS 1.3
التشفيرالمفتاح الخاص (Private Key)
لا تشارك هذا المفتاح أبداً. استخدمه فقط من خادم الـ backend.
المفتاح العام (Public Key)
يمكنك استخدامه في واجهة المستخدم (Frontend).
تنبيه أمني
تأكد من إضافة المفتاح الخاص فقط في متغيرات البيئة (Environment Variables) على الخادم. لا تضعه أبداً في كود JavaScript.
POST
/api/v2/messages/send
إرسال رسالة واتساب
| المعامل | النوع | الوصف | |
|---|---|---|---|
| phone | string | رقم الهاتف بالمفتاح الدولي | مطلوب |
| message | string | نص الرسالة | مطلوب |
| media_url | string | رابط صورة أو فيديو مرفق | اختياري |
| delay | integer | تأخير بالثواني قبل الإرسال | اختياري |
// مثال: إرسال رسالة واتساب
const response = await fetch('https://api.meta-platform.io/v2/messages/send', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"phone": "+201012345678",
"message": "مرحباً! طلبك جاهز للشحن 📦"
})
});
GET
/api/v2/contacts
جلب قائمة جهات الاتصال
| المعامل | النوع | الوصف | |
|---|---|---|---|
| page | integer | رقم الصفحة (افتراضي: 1) | اختياري |
| limit | integer | عدد النتائج (أقصى: 100) | اختياري |
| list_id | string | معرف القائمة المحددة | اختياري |
// الاستجابة:
{
"success": true,
"data": [
{ "id": 1, "name": "أحمد محمد", "phone": "+201012345678" },
{ "id": 2, "name": "سارة أحمد", "phone": "+201123456789" }
],
"pagination": { "page": 1, "total": 1250 }
}
POST
/api/v2/campaigns/create
إنشاء حملة رسائل مجمعة
| المعامل | النوع | الوصف | |
|---|---|---|---|
| name | string | اسم الحملة | مطلوب |
| list_id | string | معرف قائمة المستهدفين | مطلوب |
| message | string | نص الرسالة مع المتغيرات | مطلوب |
| schedule_at | datetime | وقت الجدولة (ISO 8601) | اختياري |
DELETE
/api/v2/contacts/{id}
حذف جهة اتصال
يحذف جهة الاتصال نهائياً من قاعدة البيانات. لا يمكن التراجع.
PUT
/api/v2/contacts/{id}
تحديث بيانات جهة اتصال
تحديث اسم أو رقم هاتف جهة الاتصال الحالية.
إعداد Webhook URL
سنرسل لك إشعارات فورية (POST) على هذا الرابط عند حدوث أي حدث.