212+ عملية API موثقة OpenAPI 3.0 عربي + إنجليزي

كل ما تحتاجه لتشغيل واتساب برمجياً

بوابة واحدة للأرقام والرسائل والعملاء والفوترة والحماية — واجهة REST بسيطة، لوحة تحكم عصرية، وتوثيق يقرؤه البشر والآلة.

212 عملية موثّقةREST API v1 · JSON فقط
78 رمز خطأ ثابتاًتُتحقق منها الاختبارات آلياً
9 طبقات حماية مدمجةكل رسالة تُفحص قبل خروجها

الإرسال في طلب واحد

طلب HTTP واحد يحمل نصاً أو مرفقاً ويرد بمعرّف الرسالة في واتساب. والإرسال بالدفعات يعالج حتى 100 رسالة في الطلب، ويمكن متابعة الحالة بالسحب أو إرسالها إلى خادمك.

POST/api/v1/client/messages/send
POST/api/v1/client/messages/send-batch
POST/api/v1/client/messages/send-media
GET/api/v1/client/messages/status/:wa_message_id
  • نص وصور وفيديو وصوت ومستندات — ومحرك الحماية نفسه أمام كل رسالة.
  • الدفعات: حتى 100 رسالة في طلب واحد ولكل واحدة نتيجتها.
  • الرد يحمل wa_message_id — المفتاح للسحب وإشعارات Webhook.
  • الأخطاء تعود برمز ثابت مقروء آلياً + سبب بالعربية يفهمه الإنسان.

الجلسات وربط الأرقام

اربط رقماً بمسح رمز QR من الأجهزة المرتبطة، أو اطلب كود إقران وأدخله داخل واتساب. كل جلسة تخص مستخدماً واحداً وتبقى معزولة تماماً عن أي جهاز آخر.

POST/api/v1/app/clients/:clientId/sessions
POST/api/v1/app/sessions/:sessionId/connect
POST/api/v1/app/sessions/:sessionId/connect-phone
  • مساران للربط: صورة QR (سريعة الانتهاء) أو كود إقران للهاتف.
  • حالة حيّة: qr → connecting → connected تُسحب من مسار حالة الجلسة.
  • عدة أرقام (أجهزة) حسب حد باقتك — كل واحد قابل للربط والفصل والاستقلال.
  • يمكن حذف الجهاز قبل الربط؛ وبعده يظهر في قائمة الأجهزة للإدارة.
  • الجلسة الموقوفة (pause_reason) تتوقف عن الإرسال بأمان مع SESSION_PAUSED.

واجهة المطورين

REST خالص فوق HTTPS وJSON فقط، بخمس طرق مصادقة وسطر curl واحد يفصلك عن أول رسالة.

cURL
curl -X POST https://your-gateway.com/api/v1/client/messages/send \
  -H "X-API-Key: wsk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"to": "9665XXXXXXXX", "text": "Hello!"}'

5 طرق مصادقة

JWT · X-API-Key (wsk_live) · X-App-Key (wsapp_live) · X-Bootstrap-Key · public

مواصفة OpenAPI آلية

GET /openapi.json — 147 مساراً جاهزاً لمولّدات الكود والوكلاء

78 رمز خطأ ثابتاً

كل رفض يحمل رمزاً وسبباً بالعربية وrequest_id لربط السجلات.

ترويسات حد المعدل

Retry-After يخبرك تماماً بموعد إعادة المحاولة: 60s / 600s / 3600s.

المرجع الكامل — المصادقة، العملاء، الجلسات، الإرسال، الأخطاء، الأمان — في /docs.

إشعارات التسليم والتتبع

اشترك خادمك في أحداث التسليم بدل السحب: البوابة ترسل كل تغيير حالة إلى رابطك، وتسجّل الردود ≥ 300، وتبقي سجل الرسائل كاملاً قابلاً للاستعلام.

POST/api/v1/client/webhooks
POST/api/v1/client/messages/status
  • اشترك وفعّل وأوقف واشترك دون تغيير في الكود.
  • بديل السحب: GET status/:wa_message_id عند عدم توفر قناة الدفع.
  • تُقبل روابط http:// وhttps:// فقط، بمهلة 8 ثوانٍ.

لوحة تحكم عصرية

واجهة بأسلوب BankDash تشغّل العملية كاملاً: إحصائيات حيّة، سجل الرسائل، الأجهزة المرتبطة، مفاتيح API، الباقات، العملاء، ووحدة تحكم المالك.

إحصائيات ورسوم بيانية

المُرسل والمحجوب والمتبقي وحالة التسليم بنظرة واحدة.

سجل الرسائل

الحالة والوقت ورمز الرفض لكل محاولة.

المفاتيح والجلسات

أنشئ وجدّر وألغِ مفاتيح التطبيقات والعملاء؛ وأدر الأجهزة المرتبطة.

وحدة المالك /zico

المستخدمون والجلسات والمؤشرات وشرائح التسعير والتخفيضات.

منصّة متعددة المستأجِرة

التطبيق هو مستؤجرك داخل البوابة: مفتاحه wsapp_live المُجزّأ، وباقاته الخاصة، وعملاؤه وجلساته — وبيانات تطبيق آخر غير موجودة أمامه أصلاً.

باقات إعادة البيع

حدد سعرك ومدتك وحدودك — دون تجاوز الباقة الأساسية.

محاسبة مدمجة

إيراد البيع مقابل تكلفة المنصة — هامشك لكل باقة في /accounting.

تسجيل العملاء

تسجيل تلقائي أو كود من المنصة — ومفتاح wsk_live يُمنح مرة واحدة فقط.

الاشتراكات والفوترة

GET/api/v1/subscription
GET/api/v1/usage
  • الحصة تُعرض كحدود/مستهلك/متبقي داخل فترة — وتوقف لطيف مع رمز واضح عند النفاد.
  • الباقة المجانية: 300 رسالة للبدء دون بطاقة.
  • تخفيضات باقات المنصة: شارة + سعر قديم مشطوب + سعر جديد، دون تغيير الأسعار المخزّنة إطلاقاً.
  • شراء داخل التطبيق عبر Google Play مع التحقق من purchase_token وحماية من التكرار.
  • الباقات المخصصة تُسعّر بالاقتباس: رسائل ÷ 1000 × سعر الشريحة + الأجهزة الإضافية.

حماية مدمجة في كل إرسال

تسع طبقات — حدود المستلمين، التكرار، المحتوى، الروابط، المعدل، الإحماء، الحصة وغيرها — تعمل قبل خروج أي رسالة، وكل رفض يعود برمزه الثابت.

التفصيل الكامل بالرموز وحدود المعدل وقواعد الإحماء في صفحة الحماية. صفحة الحماية

هوية ثنائية اللغة

  • العربية والإنجليزية في الواجهة كاملة — الرئيسية واللوحة والتوثيق.
  • وضع فاتح وداكن يُحفظ لكل مستخدم.
  • خط Estedad وتخطيط من اليمين لليسار أولاً.
  • اسم المنصة ورقم الدعم إعدادات — تُقرأ من مسار الإعدادات العامة.

جاهز لتشغيل واتساب في نظامك؟

سجّل خلال 30 ثانية — 300 رسالة مجاناً.

ابدأ الآن مجاناً اقرأ توثيق API