الجلسات

هذه المسارات خاصة بمفتاح الحساب وعلى جلسات هذا الحساب.

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

GET /instances
scope: sessions.read

إنشاء جلسة

POST /instances
scope: sessions.create

{"display_name": "Sales"}

حالة جلسة

GET /instances/{instance_id}
scope: sessions.read

مع صلاحية مؤشر الكتابة تظهر typing_enabled و typing_seconds. مع صلاحية الفاصل تظهر send_gap_enabled و send_gap_seconds.

تشغيل الجلسة

POST /instances/{instance_id}/start     sessions.start
POST /instances/{instance_id}/stop      sessions.stop
POST /instances/{instance_id}/restart   sessions.restart
POST /instances/{instance_id}/logout    sessions.logout

الإيقاف يوقف الجلسة فقط. تسجيل الخروج يلغي ربط واتساب وتبقى الجلسة.

رمز الربط

GET /instances/{instance_id}/qr
scope: sessions.qr

HTTP 200  image
HTTP 409  QR_NOT_READY

الصورة تُرجع عندما تكون الجلسة بانتظار المسح. إذا كانت مربوطة يرجع 409 حتى يُستدعى logout.

إعدادات الجلسة والقيود

PATCH /instances/{instance_id}/typing
scope: sessions.typing
{"enabled": true, "seconds": 3}

PATCH /instances/{instance_id}/send-gap
scope: sessions.send_gap
{"enabled": true, "seconds": 5}

GET /instances/{instance_id}/restrictions
scope: sessions.restrictions

حذف الجلسة

DELETE /instances/{instance_id}
scope: sessions.delete

مفتاح الجلسة

GET  /instances/{instance_id}/api-key
scope: sessions.api_key.read
→ { "api_key": "tp_ins_…" }

POST /instances/{instance_id}/api-key/rotate
scope: sessions.api_key.rotate

عرض مفتاح الجلسة يعيد السر كاملاً. التدوير يصدر tp_ins_… جديداً ويوقف القديم فوراً.