重置 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代码示例。
调试
授权信息
请求语法
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"
}
错误码
变更历史
该文章对您有帮助吗?