POST/api/v1/admin/users/:userId/force-offline强制下线

吊销目标用户全部会话并作废其刷新令牌;账号状态不变。

Request

Headers

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

URL Parameters

Name Data Type Description
userId string 用户 ID

Response

Body

NameData TypeRequiredDescription
revokednumberYes实际吊销的会话数
type ResponseBody = {
  /** 实际吊销的会话数 */
  revoked: number
}
{
  "revoked": 5
}

HTTP Code

HTTP Status Meaning Notes
200 成功 返回吊销数量

Response Code

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

code Meaning Notes
0 成功 返回吊销数量

Examples

POST /api/v1/admin/users/01JD8SEGQ0P9N2XK4L7VDH3T6C/force-offline
Authorization: Bearer st_7c1f9e05b28d4a63
{
  "id": "01JD8ST2SX7S0UJ",
  "code": 0,
  "messages": [],
  "result": { "revoked": 5 }
}