GET/api/v1/auth/session查看当前会话信息

Try it 面板需要启用 JavaScript。

返回当前会话的可展示信息（来源、设备、活跃与过期时间）。

Request

Headers

Name	Data Type	Required	Description
Authorization	string	Yes	会话令牌认证，格式 `Bearer <sessionToken>`

type RequestHeaders = {
  /** 会话令牌认证，格式 `Bearer <sessionToken>` */
  Authorization: string
}

Response

Body

SessionDTO

Name	Data Type	Required	Description
sessionId	string	Yes	会话 ID（ULID）
userId	string	Yes	用户 ID
ip	string	Yes	签发时来源 IP
userAgent	string	No	签发时 User-Agent 摘要
device	string	No	设备描述（由 UA 解析）
createdAt	string	Yes	签发时间（ISO 8601 UTC）
lastActiveAt	string	Yes	最近活跃时间
expiresAt	string	Yes	过期时间

type SessionDTO = {
  /** 会话 ID（ULID） */
  sessionId: string
  /** 用户 ID */
  userId: string
  /** 签发时来源 IP */
  ip: string
  /** 签发时 User-Agent 摘要 */
  userAgent?: string
  /** 设备描述（由 UA 解析） */
  device?: string
  /** 签发时间（ISO 8601 UTC） */
  createdAt: string
  /** 最近活跃时间 */
  lastActiveAt: string
  /** 过期时间 */
  expiresAt: string
}

{
  "sessionId": "01JD8SEGVK6MZ7W3Q4RT5N8YB2",
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "ip": "203.0.113.24",
  "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
  "device": "macOS · Chrome",
  "createdAt": "2026-10-14T08:00:00Z",
  "lastActiveAt": "2026-10-14T09:12:30Z",
  "expiresAt": "2026-11-13T08:00:00Z"
}

HTTP Code

HTTP Status	Meaning	Notes
200	成功	返回当前会话

Response Code

响应使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	返回当前会话

Examples

GET /api/v1/auth/session
Authorization: Bearer st_7c1f9e05b28d4a63

{
  "id": "01JD8SHAX5N2M6C5",
  "code": 0,
  "messages": [],
  "result": {
    "sessionId": "01JD8SEGVK6MZ7W3Q4RT5N8YB2",
    "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
    "ip": "203.0.113.24",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
    "device": "macOS · Chrome",
    "createdAt": "2026-10-14T08:00:00Z",
    "lastActiveAt": "2026-10-14T09:12:30Z",
    "expiresAt": "2026-11-13T08:00:00Z"
  }
}