الانتقال إلى المحتوى الرئيسي
POST
إنشاء جلسة

إنشاء جلسة

POST /v1/agent-sessions ينشئ جلسة مصادقة جديدة لوكيل آلة. تربط الجلسة رمز وصول محدود الوقت ورمز تحديث بالوكيل، مع مجموعة نطاق صريحة يجب أن تكون مجموعة فرعية من النطاقات الممنوحة للوكيل. يتم إرجاع token وrefresh_token فقط في استجابة الإنشاء. قم بتخزينها بأمان - لا يمكن استردادها لاحقًا.
يتم إرجاع حقلي token و refresh_token مرة واحدة فقط في هذا الاستجابة. قم بتخزينها في مدير أسرار آمن أو تخزين مشفر فورًا. إذا فقدت، قم بإنهاء الجلسة وإنشاء جلسة جديدة.

المصادقة

يتطلب رأس X-API-Key أو رمز Bearer JWT. يتم اشتقاق مساحة العمل من بيانات الاعتماد الموثقة؛ لا ترسل X-Tenant-ID.

الاستجابة

object
كائن الجلسة الذي تم إنشاؤه ويحتوي على:
string
المفتاح الأساسي UUID الداخلي.
string
معرف جلسة MAIP بالتنسيق maip-sess:<short-uuid>:<random-hex>. استخدم هذا المعرف في استدعاءات API اللاحقة.
string
الوكيل الذي تنتمي إليه هذه الجلسة.
string
حالة الجلسة. دائمًا "active" عند الإنشاء.
string[]
النطاقات الفعالة لهذه الجلسة.
object
بيانات تعريف الجلسة.
string
طابع زمني لانتهاء صلاحية ISO 8601.
string
طابع زمني لإنشاء ISO 8601.
string
طابع زمني لآخر تحديث ISO 8601.
string
رمز وصول مبهم لمصادقة طلبات API داخل هذه الجلسة. سلسلة سداسية عشرية مكونة من 64 حرفًا. تُرجع مرة واحدة فقط.
string
رمز لتحديث الجلسة قبل انتهاء صلاحيتها. سلسلة سداسية عشرية مكونة من 64 حرفًا. يتم إرجاعه مرة واحدة فقط.

مثال


دورة حياة الجلسة

يتم إنشاء إيصال الجلسة تلقائيًا عند بدء الجلسة، مما يربط الجلسة بمسار تدقيق الوكيل.

التفويضات

X-API-Key
string
header
مطلوب

مفتاح API للمصادقة من جهاز إلى جهاز

الجسم

application/json
agent_id
string<uuid>
مطلوب

الوكيل لإنشاء الجلسة له

metadata
any
scopes
string[]

نطاقات هذه الجلسة (يجب أن تكون مجموعة فرعية من نطاقات الوكيل)

ttl_minutes
integer

الاستجابة

تم إنشاء الجلسة

session_id
string<uuid>
agent_id
string<uuid>
token
string

رمز حامل الجلسة (يُرجع مرة واحدة عند الإنشاء)

scopes
string[]
status
enum<string>
الخيارات المتاحة:
active,
terminated,
expired
metadata
object
expires_at
string<date-time>
created_at
string<date-time>
terminated_at
string<date-time>