文档首页/ iMasterCloud/ API参考/ API说明/ 统一认证服务/ 多集群下用户认证服务/ 删除token
更新时间：2025-09-24 GMT+08:00
查看PDF
分享

删除token

典型场景

多集群场景使用，三方系统对接时，用户获取的token不再使用后，可以通过Global IP调用此接口以主动释放token。

接口功能

多集群场景，Global提供北向注销token功能。

接口约束

多集群场景下，使用Global IP地址。

调用方法

DELETE

URI

/controller/campus/api/v1/multiregion/tokens

表1 query参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

regionName

是

string

1~64个字符。

-

区域名称

"Region1"

请求参数

表2 header参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

X-ACCESS-TOKEN

是

string

1~1024个字符。

-

该字段可能包含敏感信息和个人数据，请妥善做好保护。

token标识

"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

请求示例

HTTP的示例 
DELETE /controller/campus/api/v1/multiregion/tokens?regionName=Region1 HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json;charset=UTF-8
Accept: application/json
X-ACCESS-TOKEN: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

响应参数

返回状态码为200：删除token成功

表3 RevokeTokenOut对象的参数列表

参数名称

类型

参数值域

默认值

参数说明

参数示例

errcode

string

0~128个字符。

-

错误码

"0"

errmsg

string

0~128个字符。

-

错误信息

""

返回状态码为401：认证失败

详细信息请参见实际响应消息体。

响应示例

返回状态码为200：删除token成功

HTTP/1.1 200 OK
Date: Wed,24 Sep 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
	"errcode" : "0",
	"errmsg" : ""
}

返回状态码为401：认证失败

HTTP/1.1 401 Unauthorized
Date: Wed,24 Sep 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive

相关文档