...
1、服务级错误:网络或运营商导致的服务级别错误。(建议第三方应用中捕获http不等于2xx的状态码,如404、502等)
| Code Block |
|---|
|
HTTP/1.1 502 Bad Gateway |
2、系统级错误:REST API 请求中传入了非法参数或者数据格式错误。(建议第三方在应用中捕获 json.status[0] = 1)
| Code Block |
|---|
|
HTTP/1.1 200 ok
{
"data": "系统级错误,请联系VNNOX管理员,谢谢!",
"status": [1]
} |
3、业务级错误:REST API因业务限制返回的状态码/错误码(json.status)。(建议第三方应用根据状态码说明处理API结果)
| Code Block |
|---|
|
HTTP/1.1 200 ok
{
"http_code": 200,
"data": {
"roleName": ""
},
"status": [50101201]
} |
HTTP方法
Vnnox REST API 目前支持4中HTTP方法:
| 方法名 | 描述 |
|---|
| GET | 用于获取资源状态 |
| POST | 用于创建资源 |
| DELETE | 用于删除资源 |
| PUT | 用于修改资源状态 |
认证
Vnnox REST API使用Oauth2.0认证,请使用认证接口获取tokan(加入到 HTTP-header中)
| Code Block |
|---|
| firstline | 1 |
|---|
| title | Request Header |
|---|
|
Accept:application/nova.vnnox.v1+json
token:5c1354529946bc49360641f7f321611698deb371 |
分页
指定用户代理
次数限制