REST API

تحكّم بمنصة نباهة برمجياً — أنشئ وكلاء، أطلق مكالمات، واسحب التقارير

مصادقة JWT

Bearer token في كل طلب

Rate Limiting

١٠٠ طلب / دقيقة

JSON Response

كل الردود بصيغة JSON

المصادقة

أرسل الـ access token في هيدر Authorization مع كل طلب:

curl -X GET "https://nabaha.otekit.com/api/v1/agents" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

نقاط الوصول (Endpoints)

الوكلاء

GET/api/v1/agentsعرض جميع الوكلاء

POST/api/v1/agentsإنشاء وكيل جديد

PUT/api/v1/agents/{id}تعديل وكيل

DELETE/api/v1/agents/{id}حذف وكيل

المكالمات

GET/api/v1/callsعرض سجل المكالمات

GET/api/v1/calls/{id}تفاصيل مكالمة

GET/api/v1/calls/{id}/transcriptsنص المكالمة

POST/api/v1/voice/connect/{agentId}بدء مكالمة صوتية

قاعدة المعرفة

GET/api/v1/knowledge-basesعرض قواعد المعرفة

POST/api/v1/knowledge-basesإنشاء قاعدة معرفة

POST/api/v1/knowledge-bases/{id}/documentsرفع مستند

التحليلات

GET/api/v1/dashboard/statsإحصائيات لوحة التحكم

GET/api/v1/billing/subscriptionمعلومات الاشتراك

GET/api/v1/billing/invoicesالفواتير

مثال: إنشاء وكيل جديد

curl -X POST "https://nabaha.otekit.com/api/v1/agents" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "سارة",
    "language": "ar-SA",
    "voice_id": "your-voice-id",
    "system_prompt": "أنتِ سارة، موظفة خدمة عملاء..."
  }'

جاهز تبني تكاملك؟

سجّل واحصل على API key من لوحة التحكم