Skip to content

关闭安全会话

POST/web/v1/secure-channel/session/closeNone

使一个已有的安全通道会话失效,立即撤销对关联加密密钥的访问权限。关闭后,使用该会话 ID 的所有请求将被拒绝。

鉴权

Auth Chain: None — 这是一个公开接口,不需要 JWT 或 Turnstile。

请求参数

NameTypeRequiredInDescription
X-Secure-Channel-Session-IdstringYesheader要失效的会话 ID

成功响应

无内容200
{
  "version": "1.3.0",
  "timestamp": 1709337600000,
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": null
}

错误响应

Bad Request400
{
  "success": false,
  "code": "4000",
  "message": "Session ID header is required"
}

说明

  • 关闭会话是幂等操作;关闭已关闭或已过期的会话不会产生错误。
  • 会话也会根据配置的 TTL 自动过期。
  • 客户端应在不再需要会话时显式关闭,以最小化密钥暴露窗口。

内部文档