توثيق LiteNotify WhatsApp API

الأساسيات

العنوان الأساسي للـ API: https://litenotify.litesoftit.com/

• طلبات JSON بترميز UTF-8
• بعد تسجيل الدخول أرسل التوكن في الرأس: Authorization: Bearer {token}
• جلسة واتساب تُربط برقم المستخدم عبر QR من العميل/اللوحة ثم تُستخدم في الإرسال

1) تسجيل الدخول

POST /api/auth/login

curl -X POST "https://litenotify.litesoftit.com/api/auth/login" \
  -H "Content-Type: application/json" \
  -d "{\"Username\":\"your_user\",\"Password\":\"your_password\"}"

الاستجابة تحتوي على Access Token وبيانات المستخدم.

2) حالة الاتصال

GET /api/whatsapp/status

curl "https://litenotify.litesoftit.com/api/whatsapp/status" \
  -H "Authorization: Bearer YOUR_TOKEN"

3) بدء الاتصال / QR

POST /api/whatsapp/connect

يبدأ ربط جلسة واتساب للمستخدم الحالي. امسح رمز QR من تطبيق واتساب حتى تصبح الجلسة متصلة.

4) إرسال رسالة نصية

POST /api/whatsapp/send-message

curl -X POST "https://litenotify.litesoftit.com/api/whatsapp/send-message" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{
    \"PhoneNumber\": \"9665XXXXXXXX\",
    \"Message\": \"مرحباً من LiteNotify\",
    \"IsGroup\": false
  }"

5) إرسال وسائط

POST /api/whatsapp/send-media

{
  "PhoneNumber": "9665XXXXXXXX",
  "MediaPath": "/path/or/url",
  "Caption": "اختياري"
}

6) طلب سداد الرسوم (Admin)

POST /api/whatsapp/send-fee-request

يتطلب صلاحية Admin. يرسل من جلسة المستخدم رقم 1 ويحدّث LastFeeRequestAt للمستهدف.

{
  "TargetUserId": 10,
  "PhoneNumber": "9665XXXXXXXX",
  "Message": "يرجى سداد رسوم خدمة واتساب بمبلغ 50$."
}

ملاحظات مهمة

• الرقم يُفضّل بصيغة دولية بدون + أو مسافات
• يجب أن تكون جلسة واتساب للمستخدم متصلة قبل الإرسال
• هذه المنصة تعتمد جلسة WhatsApp Web (QR) وليست Cloud API الرسمية من Meta