鉴权
从快速开始的样例中,可以看到 CloudTower API 的使用一共分为 2 步,第一步是通过登陆获取鉴权用的 token,第二步是通过 Authorization header 携带 token,并调用对应的 API 来进行操作。其中第一步获取的 token 并没有过期时间,可以一直使用,所以在一系列的操作中,只需要获取一次 token 即可。
除了登录以外,所有的请求都需要加上鉴权字段。
CloudTower API 通过在 headers 中传递 Authorization
字段进行鉴权,token 的获取方式如下, 以 cURL 为例:
curl -X 'POST' \
'http://CLOUDTOWER_IP/v2/api/login' \
-H 'accept: application/json' \
-H 'content-language: en-US' \
-H 'Content-Type: application/json' \
-d '{
"username": "string",
"source": "LOCAL",
"password": "string"
}'
获取到
{
"task_id": "string",
"data": {
"token": "string"
}
}
其中 data.token
是需要用到的鉴权字段,加入到 header.Authorization
即可。
- 如果通过 cURL 调用, 则加入
-H 'Authorization: token-string'
。 - 如果通过 swagger api 文档页面调用,则点击
Authorization
按钮,将data.token
填入到value
中即可。