List live sessions
GET
/api/v1/admin/sessions
prm_report_sessions
Sessions with no stop time, paginated with the standard list parameters. A non-admin caller sees only sessions belonging to their own manager subtree, injected server-side.
user_id is null for a session this instance cannot tie to a subscriber row, such as an anonymous voucher or an orphan left by a NAS restart. status and usage are absent on those too. Do not assume every live session has an owner.
نظرة سريعة
- المصادقة
- رمز موظّف أو جلسة
- تتطلب صلاحية
-
prm_report_sessionsSessions report
المعاملات
| المعامل | الوصف |
|---|---|
q
query · string
|
Searches username, first and last name, framed IP, device MAC and NAS name. |
filter[nas_id]
query · integer
|
Sessions on one registered NAS. |
filter[kind]
query · enum
|
subscriber, guest, voucher or unknown. |
filter[has_ip]
query · boolean
|
Sessions that were assigned a framed IP. |
filter[duration_band]
query · string
|
Duration bucket. The value "stale" means no accounting update for longer than the tenant's idle window, which is the practical definition of a ghost session. |
filter[expired]
query · boolean
|
Sessions whose owner's subscription has run out but who are still connected. |