توثيق API - المرسل الذكي

POST /api/messages

إرسال رسالة لرقم واحد. الرسالة تدخل في قائمة الانتظار وترسل من الإضافة.

// JavaScript
fetch('https://wa.smart-whats.com/api/messages', {
  method: 'POST',
  headers: {
    'X-API-Key': 'wsk_xxxxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phone: '966500000000',
    content: 'مرحباً! هذه رسالة تجريبية'
  })
})

# curl
curl -X POST https://wa.smart-whats.com/api/messages \
  -H "X-API-Key: wsk_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"phone":"966500000000","content":"مرحباً!"}'

الاستجابة:

{ "id": 1, "status": "pending" }

POST /api/messages/bulk

إرسال رسائل جماعية لعدة أرقام (مع دعم المرفقات).

// JavaScript - إرسال جماعي
const formData = new FormData();
formData.append('phones', JSON.stringify(['966500000001', '966500000002']));
formData.append('content', 'عرض خاص لعملائنا!');

fetch('https://wa.smart-whats.com/api/messages/bulk', {
  method: 'POST',
  headers: { 'X-API-Key': 'wsk_xxxxx' },
  body: formData
})

الاستجابة:

{ "batchId": "uuid...", "count": 2, "status": "pending" }

GET /api/messages

عرض رسائلك مع فلاتر (الحالة، batch_id، صفحة).

fetch('https://wa.smart-whats.com/api/messages?status=sent&page=1', {
  headers: { 'X-API-Key': 'wsk_xxxxx' }
})

GET /api/stats

إحصائيات رسائلك (إجمالي، في الانتظار، مرسلة، فاشلة).

fetch('https://wa.smart-whats.com/api/stats', {
  headers: { 'X-API-Key': 'wsk_xxxxx' }
})

الاستجابة:

{ "total": 150, "pending": 5, "sending": 1, "sent": 140, "failed": 4 }

PATCH /api/messages/:id/status

تحديث حالة رسالة (تُستخدم من الإضافة عادةً).

DELETE /api/messages

حذف رسائل حسب الدُفعة أو الحالة أو حذف الكل.