API Documentation

SessionOS API يتيح لك دمج نظام الجلسات الذكي مع أي منصة. كل الـ endpoints تستخدم JSON وتدعم CORS.

Base URL

https://api.session-os.io/v1

المصادقة (Authentication)

كل الطلبات تحتاج API Key في الـ header:

Authorization: Bearer sk_live_your_api_key_here

Endpoints

GET/v1/health

فحص حالة الخدمة

RESPONSE

{
  "status": "healthy",
  "service": "session-os",
  "version": "1.0.0",
  "timestamp": "2026-04-11T08:00:00.000Z"
}
POST/v1/intake

إرسال استمارة طلب جلسة جديدة

REQUEST BODY

{
  "name": "أحمد محمد",
  "phone": "+966501234567",
  "email": "ahmed@example.com",
  "request_reason": "أحتاج مساعدة في اتخاذ قرار مهني",
  "urgency_reason": "الموعد النهائي خلال أسبوعين",
  "biggest_challenge": "الخوف من الفشل",
  "impact_score": 7,
  "session_goal_type": "قرار محدد",
  "crisis_flag": false
}

RESPONSE

{
  "success": true,
  "data": {
    "id": "sr_1712819200_abc123",
    "client_id": "cl_1712819200",
    "status": "prep_pending",
    "triage": {
      "crisis_flag": false,
      "urgency_score": 7,
      "recommendation": "proceed"
    }
  }
}
POST/v1/brief/generate

توليد ملخص ذكي للجلسة بالذكاء الاصطناعي

REQUEST BODY

{
  "session_request_id": "sr_1712819200_abc123"
}

RESPONSE

{
  "success": true,
  "data": {
    "visible_problem": "صعوبة في اتخاذ القرارات المصيرية",
    "emotional_signal": "خوف عميق من الفشل ممزوج بالإحباط",
    "hidden_need": "يحتاج للاعتراف بقدرته على التغيير",
    "expected_goal": "خطة عملية للانتقال المهني",
    "first_hypothesis": "المشكلة في نمط التعامل مع القرارات الكبيرة",
    "session_boundaries": "ركز على الأنماط العاطفية، لا الإرشاد المهني",
    "confidence_score": 0.82
  }
}
POST/v1/webhooks

تسجيل webhook لاستقبال الأحداث

REQUEST BODY

{
  "url": "https://your-app.com/webhooks/session-os",
  "events": ["intake.submitted", "brief.generated", "session.completed"],
  "secret": "whsec_your_signing_secret"
}

RESPONSE

{
  "success": true,
  "data": {
    "webhook_id": "wh_1712819200_xyz789",
    "events": ["intake.submitted", "brief.generated", "session.completed"]
  }
}

أحداث الـ Webhook

intake.submittedعند إرسال استمارة جديدة
intake.triagedعند اكتمال تصنيف الأولوية
brief.generatedعند توليد الملخص الذكي
session.startedعند بدء الجلسة
session.completedعند انتهاء الجلسة
report.generatedعند توليد التقرير النهائي
crisis.detectedعند اكتشاف حالة أزمة

قريباً: SDK

📦

npm install @session-os/sdk

SDK رسمي لـ JavaScript / TypeScript — قريباً