#### **附錄一 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不對數據做驗證處理直接顯示。