中消云物联网研究院

本页面只读。您可以查看源文件，但不能更改它。如果您觉得这是系统错误，请联系管理员。

<h3>1.API_TOKEN说明</h3>API_TOKEN（简称token）是本平台的全局唯一接口调用凭据，在调用各接口时都需将API_TOKEN放入header存储关于。开发者需要进行妥善保存。API_TOKEN的存储至少要保留100个字符空间。API_TOKEN的有效期为长期有效，重复获取将导致上次获取的API_TOKEN失效。API调用所需的API_TOKEN的使用及生成方式说明：建议开发者使用中控服务器统一获取和刷新API_TOKEN，其他业务逻辑服务器所使用的API_TOKEN均来自于该中控服务器，不应该各自去刷新，否则容易造成冲突，导致API_TOKEN覆盖而影响业务；开发者可以使用appkey和masterSecret调用本接口来获取API_TOKEN。appkey和masterSecret可联系中消云获得。<h3>2.业务接口调用方法</h3>除“获取API_TOKEN”以外其它接口均需要在header中设置API_TOKEN值请求样例：GET http: /login/api/2.0/auth/getToken HTTP/1.1Host: //www.zxyun119.com/thirdPartyApiAPI_TOKEN: aab8e8f2-9f5c-41c8-b370-e03e1bf2c726Cache-Control: no-cache<h3>3.服务器地址&nbsp;&nbsp;&nbsp;</h3><h4><table border="1" cellspacing="0"><tbody><tr><td style="width:97.5500pt;">替换字符</td><td style="width:400.8500pt;">服务器地址</td></tr><tr><td style="width:97.5500pt;">authServerUrl</td><td style="width:400.8500pt;">https://www.zxyun119.com/thirdPartyApi/login</td></tr><tr><td style="width:97.5500pt;">projectServerUrl</td><td style="width:400.8500pt;">https://www.zxyun119.com/thirdPartyApi/ThreePlaceREST</td></tr><tr><td style="width:97.5500pt;">testPageUrl</td><td style="width:400.8500pt;">https://www.zxyun119.com/thirdPartyApi </td></tr></tbody></table></h4><h4>&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;</h4><h3>4.返回说明</h3><h2>&nbsp; &nbsp; (1).HTTP状态码</h2><table border="1" cellspacing="0"><tbody><tr><td style="width:62.1000pt;">Code</td><td style="width:92.1500pt;">描述</td><td style="width:344.1500pt;">详细解释</td></tr><tr><td style="width:62.1000pt;">200</td><td style="width:92.1500pt;">OK</td><td style="width:344.1500pt;">Success!</td></tr><tr><td style="width:62.1000pt;">400</td><td style="width:92.1500pt;">参数缺失</td><td style="width:344.1500pt;">改请求有必填项无值</td></tr><tr><td style="width:62.1000pt;">401</td><td style="width:92.1500pt;">无权限</td><td style="width:344.1500pt;">没有API_TOKEN或请求没有权限</td></tr><tr><td style="width:62.1000pt;">500</td><td style="width:92.1500pt;">内部服务错误</td><td style="width:344.1500pt;">服务器内部出错了。请联系我们尽快解决问题。</td></tr><tr><td style="width:62.1000pt;">502</td><td style="width:92.1500pt;">无效代理</td><td style="width:344.1500pt;">业务服务器下线了或者正在升级。请稍后重试。</td></tr></tbody></table><h4></h4><h2>&nbsp; &nbsp; (2).返回码</h2><table border="1" cellspacing="0"><tbody><tr><td style="width:85.05pt;">返回码</td><td style="width:332.5pt;">描述</td></tr><tr><td style="width:85.05pt;">000000</td><td style="width:332.5pt;">请求成功</td></tr><tr><td style="width:85.05pt;">L01013</td><td style="width:332.5pt;">请检查路径是否正确</td></tr><tr><td style="width:85.05pt;">L02100</td><td style="width:332.5pt;">appkey无效</td></tr><tr><td style="width:85.05pt;">L02201</td><td style="width:332.5pt;">appkey与masterSecret不匹配</td></tr><tr><td style="width:85.05pt;">P00000</td><td style="width:332.5pt;">服务器内部出错了。请联系我们尽快解决问题。</td></tr><tr><td style="width:85.05pt;">P00001</td><td style="width:332.5pt;">没有结果</td></tr><tr><td style="width:85.05pt;">P01000</td><td style="width:332.5pt;">输入参数错误</td></tr><tr><td style="width:85.05pt;">P02001</td><td style="width:332.5pt;">获取数据没有权限</td></tr></tbody></table>

中消云物联网研究院

用户工具

站点工具

页面工具