Page History

...

• 版本
• 请求简述
• 参数说明
• 服务地址
• 错误调试
• HTTP方法
• 认证
• 分页
• 次数限制
• 用户代理

Anchor
banben banben

版本

默认情况下当客户端访问https://cn.vnnox.com时，系统将使用V1 版REST API提供服务，我们建议您在http请求的heaer中的`Accept`字段加上服务版本号。格式如下：

Accept:application/nova.vnnox.v1+json

...

所有请求均通过HTTPS协议，API请求链接为https://cn.vnnox.com，所有数据的请求及相应均通过json格式。

Request Header

Content-Type:application/json;charset=utf-8

Response数据结构

{
    "http_code": 200,            //http状态码(重要：请使用http协议本身的状态码做异常捕获，response data中http_code字段后期会取消掉)
    "data": {...some data...},   //数据部分
    "status": [10000001]         //业务相关状态码
}

...

如上面的例子，本文档所有涉及{host}均指https://cn.vnnox.com/，建议第三方开发者将com，建议第三方开发者将{host}信息作为可配置项

错误调试

Anchor
cuowu cuowu

...

token:5c1354529946bc49360641f7f321611698deb371

...

使用Oauth2.0认证的REST API访问，同一个用户获取的token访问频次建议1小时内不要超过3000次。

Anchor
daili daili

用户代理

所有的API请求一般都会包含User-Agent header，例如浏览器会默认设定为`Mozilla/5.0`等，如果第三方应用对接VNNOX REST API，请参照如下设置：

User-Agent: Vnnox-User-App

如果应用的HTTP请求中没有此参数设定，系统无法验证当前用户的Request请求来源，可能会影响到数据的访问。