المصادقة
تستخدم واجهة نبّه مفاتيح Bearer Token عبر Laravel Sanctum. أنشئ المفتاح من لوحة التحكم: الإعدادات → API، واختر اسماً وصلاحيات المفتاح. يظهر المفتاح كاملاً مرة واحدة فقط بعد الإنشاء — احفظه في مكان آمن.
إرسال المفتاح
أضف المفتاح في ترويسة Authorization بنوع Bearer:
curl
curl -X POST "https://nabbih.com/api/v1/whatsapp/messages/send-template"
-H "Authorization: Bearer {YOUR_API_KEY}"
-H "Content-Type: application/json"
الصلاحيات (Abilities)
لكل مفتاح صلاحيات تحدد ما يمكنه فعله:
| الصلاحية | الوصف |
|---|---|
| whatsapp:consent:write | تسجيل دليل موافقة العميل على رسائل واتساب |
| whatsapp:send | إرسال رسائل واتساب (قوالب ونصوص) والاستعلام عن حالة رسالة. |
| whatsapp:templates:read | عرض قوالب واتساب الخاصة بالنشاط. |
إدارة المفاتيح
- أنشئ مفتاحاً منفصلاً لكل نظام أو تكامل.
- ألغِ أي مفتاح مشتبه به فوراً — الإلغاء يوقف كل الطلبات التي تستخدمه في الحال.
- لا تضع المفتاح في كود الواجهة الأمامية أو تطبيقات الجوال أبداً.
خطأ مصادقة
المفتاح المفقود أو الملغى يُرجع:
401 unauthorized
{
"error": {
"code": "unauthenticated",
"message": "Unauthenticated."
}
}