بوابة المطورين (Developer Portal)
واجهة API احترافية لدمج خدماتنا في تطبيقاتك ومتاجرك الإلكترونية.
API v2.1 — نشط
12,480
طلب API (اليوم)99.7%
نسبة النجاح42ms
متوسط زمن الاستجابةTLS 1.3
التشفيرمفتاح API الشخصي (للإضافة والـ Integrations)
استخدم هذا المفتاح في إضافة جوجل كروم أو أي تكامل خارجي. تحتفظ به سراً ولا تشاركه مع أحد.
لإضافة جوجل كروم:
افتح إضافة "Meta Extractor" وأدخل الرابط
http://72.62.61.214:3000 والصق المفتاح في خانة "مفتاح API".
تنبيه أمني
عند الضغط على "تجديد" سيتوقف المفتاح الحالي فوراً وستحتاج تحديث المفتاح في كل الإضافات والتكاملات.
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) على هذا الرابط عند حدوث أي حدث.