كل ما تحتاجه لاستخدام واجهة برمجة التطبيقات لمنصة وصل
جميع طلبات API تتطلب مفتاح API صالح. يُرسل المفتاح في هيدر Authorization مع كل طلب.
Authorization: Bearer YOUR_API_TOKEN
https://waslapi.com/api/v1
| الكود | المعنى |
|---|---|
200 | نجاح |
201 | تم الإنشاء بنجاح |
400 | خطأ في البيانات المرسلة |
401 | غير مصرح - مفتاح API غير صالح |
403 | محظور - تجاوزت حد الاشتراك |
404 | غير موجود |
422 | خطأ في التحقق من البيانات |
429 | تجاوزت حد الطلبات (Rate Limit) |
500 | خطأ في الخادم |
/instances
عرض جميع أرقام الواتساب المسجلة في حسابك.
curl -X GET https://waslapi.com/api/v1/instances \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json"
$response = Http::withToken('YOUR_API_TOKEN')
->get('https://waslapi.com/api/v1/instances');
$instances = $response->json();
/instances
إنشاء رقم واتساب جديد.
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
name | string | نعم | اسم الرقم (للتعريف) |
proxy_country | string | لا | كود الدولة للبروكسي (مثال: sa, ae) |
curl -X POST https://waslapi.com/api/v1/instances \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "رقم المتجر", "proxy_country": "sa"}'
/instances/{id}/qr
جلب رمز QR لربط الرقم بتطبيق واتساب. افتح واتساب → الأجهزة المرتبطة → امسح الرمز.
curl -X GET https://waslapi.com/api/v1/instances/1/qr \
-H "Authorization: Bearer YOUR_API_TOKEN"
/instances/{id}/status
فحص حالة اتصال الرقم (متصل / غير متصل / معلّق).
/instances/{id}
حذف رقم واتساب نهائياً مع جميع بياناته.
/messages/send-text
إرسال رسالة نصية.
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
instance_id | integer | نعم | معرّف الرقم |
to | string | نعم | رقم المستلم (مع كود الدولة بدون +) |
message | string | نعم | نص الرسالة |
curl -X POST https://waslapi.com/api/v1/messages/send-text \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"instance_id": 1,
"to": "966501234567",
"message": "مرحباً! هذه رسالة تجريبية."
}'
import requests
url = "https://waslapi.com/api/v1/messages/send-text"
headers = {
"Authorization": "Bearer YOUR_API_TOKEN",
"Content-Type": "application/json"
}
data = {
"instance_id": 1,
"to": "966501234567",
"message": "مرحباً من Python!"
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
const response = await fetch('https://waslapi.com/api/v1/messages/send-text', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
instance_id: 1,
to: '966501234567',
message: 'مرحباً من Node.js!'
})
});
const data = await response.json();
console.log(data);
/messages/send-media
إرسال رسالة وسائط (صورة، فيديو، مستند، صوت).
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
instance_id | integer | نعم | معرّف الرقم |
to | string | نعم | رقم المستلم |
media_type | string | نعم | نوع الوسائط: image, video, document, audio |
media_url | string | نعم | رابط الملف (URL عام) |
caption | string | لا | نص مرفق مع الوسائط |
filename | string | لا | اسم الملف (للمستندات) |
curl -X POST https://waslapi.com/api/v1/messages/send-media \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"instance_id": 1,
"to": "966501234567",
"media_type": "image",
"media_url": "https://example.com/photo.jpg",
"caption": "صورة المنتج"
}'
/messages
عرض سجل الرسائل المرسلة مع إمكانية الفلترة حسب الرقم والحالة والتاريخ.
| المعامل | النوع | الوصف |
|---|---|---|
instance_id | integer | فلترة حسب رقم محدد |
status | string | حالة الرسالة: sent, delivered, failed |
date_from | date | من تاريخ (YYYY-MM-DD) |
date_to | date | إلى تاريخ (YYYY-MM-DD) |
per_page | integer | عدد النتائج في الصفحة (افتراضي 20) |
يمكنك تحديد Webhook URL لكل رقم واتساب عند الإنشاء أو التحديث. المنصة ترسل لك الأحداث التالية:
| الحدث | الوصف |
|---|---|
message.received | عند استقبال رسالة جديدة |
message.sent | عند إرسال رسالة بنجاح |
message.failed | عند فشل إرسال رسالة |
instance.connected | عند اتصال الرقم |
instance.disconnected | عند انقطاع اتصال الرقم |
X-Webhook-Signature يحتوي على توقيع HMAC-SHA256 للتحقق من المصدر.
/usage
عرض بيانات استهلاك الاشتراك الحالي.
curl -X GET https://waslapi.com/api/v1/usage \
-H "Authorization: Bearer YOUR_API_TOKEN"
{
"plan": "احترافي",
"messages_used": 1250,
"messages_limit": 10000,
"messages_remaining": 8750,
"bandwidth_used_mb": 45.2,
"bandwidth_limit_mb": 500,
"instances_count": 3,
"instances_limit": 5,
"expires_at": "2025-04-15"
}