توكنات API والإرسال عبر واجهة برمجية

توكنات API

يستخدم Nidaa مصادقة Bearer Token لـ REST API الخاصة به. التوكنات مرتبطة بالجهاز — كل توكن يمكنه الإرسال من الجهاز الذي أُنشئ له فقط.

إنشاء توكن

1. افتح تبويب واجهة برمجية.
2. اختر الجهاز الخاص بك.
3. انقر + إنشاء توكن وأدخل اسماً (مثل: "تكامل CRM").
4. انسخ التوكن — يُعرض مرة واحدة فقط. احفظه بأمان.

الإرسال عبر API

curl -X POST https://api.nidaa.id/api/v1/messages/send \
  -H "Token: توكنك" \
  -H "Content-Type: application/json" \
  -d '{"target":"6281234567890","message":"مرحباً من Nidaa API!"}'

الاستجابة

{ "ok": true, "id": "msg_xxx", "status": "queued" }

Webhook

اضبط عنوان Webhook على جهازك لاستقبال الرسائل الواردة وتحديثات الحالة:

1. تبويب الأجهزة ← انقر Webhook على جهاز.
2. أدخل عنوان endpoint الخاص بك.
3. سيُرسل Nidaa POST إلى ذلك العنوان لكل رسالة واردة وتغيير حالة.

حمولة Webhook (رسالة واردة)

{
  "event": "message.inbound",
  "deviceId": "dev_xxx",
  "from": "6281234567890",
  "body": "مرحباً!",
  "timestamp": "2026-06-30T10:00:00Z"
}

للتوثيق الكامل للـ API: api.nidaa.id/docs.