对于需要调用百川平台应用的接口进行二次开发的用户,百川平台提供了API Token的接入方式。API Token的生成是在百川平台,包含了权限、过期时间、名称等信息。使用API Token调用应用接口需要在header中带上X-Ca-Token
字段。
生成
进入百川工作台,再进入组织管理界面,选择【API Token】,如下图所示
点击【生成API TOKEN】按钮
填入名称、权限、过期时间信息,点击【生成API TOKEN】,生成成功会弹出token信息,需要用户记录下该token值
选择权限:根据应用API需要的权限进行配置
使用
API Token的使用和应用的API相关,在请求应用接口的时候,需要在请求头中带上X-Ca-Token
。假设牧云主机管理助手有下面接口
https://collie.rivers.chaitin.cn/api/v1/host/list
那么使用API Token的请求方式如下
curl -H 'X-Ca-Token:<API Token值>' https://collie.rivers.chaitin.cn/api/v1/host/list