更新时间:2025-08-28 GMT+08:00
分享

认证鉴权

调用接口支持使用Token认证,通过Token认证鉴权调用请求。

  • 手机app相关接口无需认证鉴权。
  • 获取token的用户,仅支持通过CloudCampus创建的用户和密码。

Token认证

Token在计算机系统中代表令牌(临时)的意思,拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限。

Token可通过调用获取token接口获取,请求body填写数据,参考如下所示:

POST /controller/campus/api/v1/multiregion/tokens?regionName=Region1
Content-Type: application/json
{
    "userName": "user_name",
    "password": "******"
}

获取Token后,再调用其他API时,您需要在请求消息头中添加“X-Auth-Token”,并赋值为Token。

例如,调用获取token接口获取的Token值为“xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx”,则调用其他API时将“X-Auth-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx”加到请求消息头中,如下所示:

DELETE /controller/campus/api/v1/multiregion/tokens?regionName=Region1
Content-Type: application/json
X-Auth-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

相关文档