#### **附录一 JSON文本实例1** ``` { "head":"标题文本", "img":"", "tag":"说明文本", "tip":"说明文本", "list": [          { "title":"元素1", "value":"78", "head":"标题文本", "img":"", "tag":"说明文本", "tip":"说明文本"          },          { "title":"元素2", "value":"47", "head":"标题文本", "img":"", "tag":"说明文本", "tip":"说明文本"          },          { "title":"元素3", "value":"99", "head":"标题文本", "img":"", "tag":"说明文本", "tip":"说明文本"          }      ] } ``` #### **附录二 JSON文本实例2** ``` { "head":"标题文本", "img":"", "tag":"说明文本", "tip":"说明文本", "list": [          { "title":"元素1", "value": {"hight":99}, "head":"标题文本", "img":"", "tag":"说明文本", "tip":"说明文本"          },          { "title":"元素2", "value": {"hight":30}, "head":"标题文本", "img":"", "tag":"说明文本", "tip":"说明文本"          },          { "title":"元素3", "value": {"hight":65}, "head":"标题文本", "img":"", "tag":"说明文本", "tip":"说明文本"          }      ] } ``` #### **附录3 WebApI接口开发标准** > WebAPI标准接口开发示例源码：https://github.com/ElonX/WebAPIDemo #### 方式一：简单接口 ***** 1.URL 如：https://localhost/test/data01 2.随机数 字段名：nonce=0422860342 3.时间戳 字段名：timestamp=1554365738 4.校验值 字段名：sign=8cwZxjASO GET方式请求： https://localhost/test/data01?nonce=0422860342&timestamp=1554365738&sign=8cwZxjASO Post方式请求： https://localhost/test/data01?nonce=0422860342&timestamp=1554365738&sign=8cwZxjASO 数据：{"a":"123","b":"321"} #### 方式二：鉴权接口 01 *** 1）第一次请求token授权 1.获取TokenURL 如：https://localhost/test/token 2.客户端标识 字段名：appid=APPID 3.时间戳 字段名：timestamp=1554365738 4.校验值 字段名：sign=8cwZxjASO 服务端根据需求自由选用以上字段做相关处理。 若启用校验值字段，sign加密方式示例如下：   生成的url访问字段如下，末端%3d%3d部分是做了转义处理：  Token授权接口服务端需要返回字段： 1.响应码 字段名code 当code=0时表示返回token正常 验证失败， code返回非0值，并且返回错误信息，字段名 error 2.Token 字段名 access_token 3.有效时间 字段名 expires_in （单位秒） 返回数据规定为json数据格式，如： ``` { "code":"0", "access_token":"token", "expires_in":"3600", } ```` 授权失败返回json，如： ```` { "code":"-1", "error":"appid validation failed", } ```` 2）第二次请求数据 1.URL 如：https://localhost/test/data02 2.随机数 字段名：nonce=0422860342 3.时间戳 字段名：timestamp=1554365738 4.校验值 字段名：sign=8cwZxjASO 5.客户端标识 字段名：appid=APPID 6.Token 字段名：token= XXXXXXXX 以上字段根据需求自由选用，做token验证处理返回数据，无类型限制。 GET方式 第一次请求Token： https://localhost/test/token?appid=APPID&timestamp=1554365738&sign=8cwZxjASO GET方式 第二次请求： https://localhost/test/data02?nonce=5481000325&token=XXXXXXXX&timestamp=1554365738&sign=8cwZxjASO GET方式 第一次请求Token： https://apis.map.qq.com/token?appid=APPID&timestamp=1554365738&sign=8cwZxjASO POST方式 第二次请求： https://apis.map.qq.com/v1?nonce=5481000325&token=XXXXXXXX&timestamp=1554365738&sign=8cwZxjASO 数据：{"a":"123","b":"321"} #### 方式三：鉴权接口02 ***** 1）第一次请求token授权 1.获取TokenURL 如：http://127.0.0.1/GetToken 2.POST请求 JSON请求样例： ``` Method: POST Request: http://ip:port/raydata/uc/getToken Header: Content-Type: application/json Body: { "appKey":"appKey", "appSecret":"appSecret" } ``` 服务端根据需求自由定义json内容做对应开发。 Token授权接口服务端需要返回字段： 1.响应码 字段名 returnCode 当 returnCode=200时表示通过验证并返回Token； 验证失败， code返回非200值，并且返回错误信息，字段名 returnMsg。 2.Token 字段名 token 3.有效时间 字段名 data 字段名 expiresSecond (单位秒) 返回数据规定标准，如： ``` response: Status Code: 200 Content-Type: application/json Body: { "returnCode":"200", "returnMsg": "SUCCESS", "token":"bearer;eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHBpcmF0aW9uIjoxNTY2MjgzMDA5NjExLCJpc3N1ZWRBdCI6MTU2NjI2MTQwOTYxMSwiaXNzdWVyIjoiY29zaGlwIiwibG9naW5JZCI6InN5c3RlbSIsInNwQ29kZSI6IjEyMyIsInVybEZyb20iOiJ1YyJ9.jLFEuEBwgkLzHsx7g8Aa7Ua0pNKkwXliV3w_mxOeqBM", "data":{ "expiresSecond":"21600" } } ``` 2）第二次请求数据 1.URL 如：http://ip:port/raydata/getData 2.Token 字段名：accessToken =********** JSON请求样例： ``` Method: POST request: http://ip:port/raydata/elevator/getElevator Header: "accessToken: *******" Content-Type:application/json Body: { "postData":"****", } ``` 服务端根据需求自由定义json内容做对应开发。 Token授权接口服务端验证成功后可根据需求返回任意json内容，RayData不对数据做验证处理直接显示。