## HTTP-API
本部分文档包含Cloud API的工具接口。
### API规范
**请求参数**
每个请求应当带上access_token，该参数可作为query参数携带，access_token为某机器人的唯一认证，组成规则ID-授权码。例如：access_token=10000-code。
例如获取接口状态：
URL：http://cloud-api.ksust.com/api/v1/util/getAPIStatus?access_token=10000-code
**返回结构**
每个API返回结构相同，均为JSON格式。其统一结构如下：
~~~
{
"status": 200,
"msg": "请求成功",
"data": {}
}
~~~
其中data为相关请求所返回的数据，例如获取接口状况，返回数据如下，其中code属性数值则为赞数量。
~~~
{
"status": 200,
"msg": "请求成功",
"data": {
"current": 50,
"total": 500,
"updateTime": 1562229761578
}
}
~~~
### 响应代码
此部分相代码为返回结构中的status，目前在用的代码如下：
|status|msg|备注|
|---|---|---|
|200|请求成功|-|
|400|请求参数错误|检查请求参数|
|403|TOKEN验证失败|QQ或code错误|
|10010|API请求次数已用完|该时段内API请求次数已用完|
