ResetToken - 重置 API Token

更新时间:
复制 MD 格式

重置 API Token

接口说明

重置用户的 Token。

业务逻辑:
1. 从 identity 取 user_id(强制 caller_type=user)
2. 构造 AuthContext,委托 UserTokenAuthorizedService 完成权限校验
3. 调用 reset_token:
   - 旧 ACTIVE Token → RESET(永久失效)
   - 生成新 ACTIVE Token
4. 返回新 Token 明文 + 脱敏值

注意:重置后旧 Token 永久失效且不可恢复。新 Token 明文仅在本次响应中返回。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /openapi/resetToken HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

tenantId

string

否

租户 ID,公共参数,缺省时使用调用方默认租户。

10000

wnUserId

string

否

目标用户 ID(WINNEXO 平台用户 ID,空则操作自身,管理员可传入他人 ID 代操作)。

1

返回参数

名称

类型

描述

示例值

object

返回结果。

code

string

状态码。

200

message

string

状态码描述。

ok

requestId

string

请求追踪 ID。

019FF406-1B10-0065-A97D-2D1920C2A03D

token

string

新 Token 明文(仅本次返回,请妥善保管)。

example_token_value

tokenMasked

string

脱敏后的 Token 值

string_value

示例

正常返回示例

JSON格式

{
  "code": "200",
  "message": "ok",
  "requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
  "token": "example_token_value",
  "tokenMasked": "string_value"
}

错误码

访问错误中心错误中心查看更多错误码。

变更历史

更多信息,参考变更详情变更详情。