请求数据

请求协议

请求的协议使用https。

请求头

1.请求的header中请不要随意增加不在报文范例中的键值对，否则服务器端可能由于无法理解请求中包含的header，而返回400 Bad Request错误。

2.所有接口请求头部都需要放入Authorization属性，值为token_type(默认为bearer) + access_token，获取token的接口除外。

3.部分接口请求头部需要指定contentType，具体参考接口的请求报文示例。

1.具体需要参考接口的请求报文示例。

2.接口中的字段长度均表示最大长度，给第三方设计数据库字段长度做参考。

3.必传参数没有传、传参方式不对、参数格式不对等情况下接口会返回参数错误，请对照接口文档进行修改。

请求示例

         POST  /xxx/xxxx  HTTP/1.1
         Host:api2.hik-cloud.com
         Content-Type:application/json; charset=utf-8
         Authorization:bearer  62c54b72-c85f-4a4e-8fd0-6941744d0af7

例如上述请求报文示例，说明了接口请求方式为POST，接口路径为xxx/xxx，协议为HTTP/1.1，请求主机地址为api2.hik-cloud.com，contentType指定了传参方式为application/json，编码方式为utf-8，Authorization指定了认证信息。

请求返回

1.请求返回的HTTP状态码为200表示请求成功，非200的错误码则为请求错误，例如401为认证失败，需要重新获取token，429为接口请求频率超过限制，500为服务端错误

2.请求返回数据中的code为200时表示请求成功，返回非200的code则需要对照错误码表进行判断，一般返回的message中已有错误信息的说明

请求数据

请求协议#

请求头#

请求数据#

请求示例#

请求返回#

请求协议

请求头

请求数据

请求示例

请求返回