الانتقال إلى المحتوى الرئيسي
GET
سرد الجلسات

قائمة الجلسات

GET /v1/agent-sessions يُرجع قائمة مُصفحة بجلسات الوكيل للمستأجر المصادق عليه. يمكن تصفية النتائج حسب معرف الوكيل وحالة الجلسة. تُرجع الجلسات بترتيب زمني عكسي (الأحدث أولاً).

المصادقة

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

الاستجابة

object[]
مصفوفة من كائنات الجلسة. يحتوي كل منها على session_id، agent_id، status، scopes, metadata, expires_at, parent_session_id, handed_off_to, ip_address، user_agent، refreshed_at، terminated_at، created_at، و updated_at. لا يتم الكشف عن تجزئات الرمز المميز أبدًا في استجابات القائمة.
integer
العدد الإجمالي للجلسات المطابقة لمعايير التصفية، عبر جميع الصفحات.

مثال


مرجع حالة الجلسة

التفويضات

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

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

معلمات الاستعلام

agent_id
string<uuid>

تصفية الجلسات حسب الوكيل

status
enum<string>

تصفية حسب حالة الجلسة

الخيارات المتاحة:
active,
terminated,
expired
limit
integer
افتراضي:25
النطاق المطلوب: 1 <= x <= 100
offset
integer
افتراضي:0
النطاق المطلوب: x >= 0

الاستجابة

قائمة الجلسات المقسمة على صفحات

items
object[]
total
integer