NATSidentity.session.validate内省校验会话

Try it 面板需要启用 JavaScript。

回源校验会话令牌并返回用户上下文——生态内所有服务共享会话（SSO）的锚点。

Request Payload

消息格式：JSON

Name	Data Type	Required	Description
sessionToken	string	Yes	会话令牌（不透明）

type RequestBody = {
  /** 会话令牌（不透明） */
  sessionToken: string
}

{
  "sessionToken": "st_7c1f9e05b28d4a63"
}

Response Payload

回复使用统一信封 {id, code, messages, result}，其 result：

Name	Data Type	Required	Description
valid	boolean	Yes	是否有效
sessionId	string	No	会话 ID
userId	string	No	用户 ID
expiresAt	string	No	过期时间

type ResponseBody = {
  /** 是否有效 */
  valid: boolean
  /** 会话 ID */
  sessionId?: string
  /** 用户 ID */
  userId?: string
  /** 过期时间 */
  expiresAt?: string
}

{
  "valid": true,
  "sessionId": "01JD8SEGVK6MZ7W3Q4RT5N8YB2",
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "expiresAt": "2026-11-13T08:00:00Z"
}

Response Code

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

code	Meaning	Notes
0	成功	内省校验会话

Examples

{ "sessionToken": "st_7c1f9e05b28d4a63" }

{
  "id": "01JD8SUY2N4D0F7GC",
  "code": 0,
  "messages": [],
  "result": {
    "valid": true,
    "sessionId": "01JD8SEGVK6MZ7W3Q4RT5N8YB2",
    "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
    "expiresAt": "2026-11-13T08:00:00Z"
  }
}