## HTTP-API
本部分文档包含Cloud API在HTTP-API上的应用。
### API规范
**请求参数**
每个请求应当带上access_token,该参数可作为query参数携带,access_token为某机器人的唯一认证,组成规则QQ-授权码。例如:access_token=10000-code。
例如发送私聊消息:
URL:http://cloud-api.ksust.com/api/v1/http-api/sendPrivateMsg?access_token=10000-code
POST参数:qq、msg、type
**返回结构**
每个API返回结构相同,均为JSON格式。其统一结构如下:
~~~
{
"status": 200,
"msg": "请求成功",
"data": {}
}
~~~
其中data为相关请求所返回的数据,例如查询某QQ赞的数量,返回数据如下,其中code属性数值则为赞数量。
~~~
{
"status": 200,
"msg": "请求成功",
"data": {
"code": 10000
}
}
~~~
### 响应代码
此部分相代码为返回结构中的status,目前在用的代码如下:
|status|msg|备注|
|---|---|---|
|200|请求成功|-|
|400|请求参数错误|检查请求参数|
|403|TOKEN验证失败|QQ或code错误|
|10010|API请求次数已用完|该时段内API请求次数已用完|