## VPS
本部分文档包含Cloud API在VPS(挂机宝)上的应用。
### API规范
**请求参数**
每个请求应当带上access_token,该参数可作为query参数携带。本部分的access_token为VPS(挂机宝)的唯一认证,组成规则VPS id-token。例如:access_token=150-code。
例如获取虚拟机状态:
URL:http://cloud-api.ksust.com/api/v1/vps/getVMStatus?access_token=150-token
**返回结构**
每个API返回结构相同,均为JSON格式。其统一结构如下:
~~~
{
"status": 200,
"msg": "请求成功",
"data": {}
}
~~~
其中data为相关请求所返回的数据,例如在本例下,返回数据如下,其中code属性数值则为赞数量。
~~~
{
"status": 200,
"msg": "请求成功",
"data": {
"id": 149,
"name": "win2012-lenovo",
"status": "ACTIVE",
"lcmStatus": "RUNNING",
"action": "status"
}
}
~~~
### 响应代码
此部分相代码为返回结构中的status,目前在用的代码如下:
|status|msg|备注|
|---|---|---|
|200|请求成功|-|
|400|请求参数错误|检查请求参数|
|403|TOKEN验证失败|QQ或code错误|
|10010|API请求次数已用完|该时段内API请求次数已用完|

