Skip to Content

Changes for page 07 HTTP API

Last modified by Devin Chen on 2025/04/10 16:16
From version 8.1
edited by Hunter
on 2023/01/11 18:56
Change comment: There is no comment for this version
To version 15.1
edited by Mora Zhou
on 2023/12/22 10:03
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -7 HTTP API
1 +07 HTTP API
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Hunter
1 +XWiki.Mora
Content
... ... @@ -43,7 +43,10 @@
43 43  
44 44  screctkey=f1cd9351930d4e589922edbcf3b09a7c
45 45  
46 +(% class="box infomessage" %)
47 +(((
46 46  **✎Note:** If it is for Virtual Deployment, the comid and comkey would not be the same with values above. Try to get the actual value from HTTP access (V-NET~-~-Services~-~-HTTP access)
49 +)))
47 47  
48 48  == **1.1 Interface Parameter Description** ==
49 49  
... ... @@ -98,7 +98,7 @@
98 98  |domain(Optional)|(% style="width:535px" %)3rd party interface domain(Only available for Virtual Deployment)
99 99  |(% rowspan="3" %)**Return value**|Items|(% style="width:535px" %)Description
100 100  |utype|(% style="width:535px" %)User Type: 1-Manage Account, 2-Viewer Account
101 -|sid|(% style="width:535px" %)User session ID
104 +|sid|(% style="width:535px" %)User session ID (Only available for 12 hours)
102 102  
103 103  **2.1.2 Operating procedures**
104 104  
... ... @@ -124,11 +124,13 @@
124 124  
125 125  "sign":"997513ff1320862f0cbb9ce19d0bd253"
126 126  
130 +{{info}}
127 127  **✎Note: **For Virtual Deployment, the sign string should be append with domain, so the format would be like following:
128 128  
129 129  alias=xxx&comid=xxx&compvtkey=xxx&domain=xxx&password=xxx&ts=1657682972386&key=f1cd9351930d4e589922edbcf3b09a7c
130 130  
131 131  The timestamp must be unit as Millisecond level
136 +{{/info}}
132 132  
133 133  **Step4: ** Set common of header
134 134  
... ... @@ -838,7 +838,7 @@
838 838  
839 839  == (% id="cke_bm_1218S" style="display:none" %)** **(%%)**3.7 {{id name="_Toc24963755"/}}Historical tag data list** ==
840 840  
841 -**​​​​​​​3.7.1 {{id name="_Toc24963756"/}}Parameters**
846 +**3.7.1 {{id name="_Toc24963756"/}}Parameters**
842 842  
843 843  (% class="table-bordered" %)
844 844  |**acturl**|(% colspan="3" %)we-data/historydata
... ... @@ -858,7 +858,7 @@
858 858  |totalRecord|(% colspan="2" %)Total records
859 859  |currentPage|(% colspan="2" %)Current page
860 860  
861 -​​​​​​​**3.7.2 Operating procedures**
866 +**3.7.2 Operating procedures**
862 862  
863 863  **Step:** Set http: [[http:~~/~~/api.v-box.net/box-data/api/we-data/historydata>>url:http://api.v-box.net/box-data/api/we-data/historydata]]
864 864  
... ... @@ -958,7 +958,7 @@
958 958  
959 959  == **3.8 Alarm tags data list** ==
960 960  
961 -**​​​​​​​​​​​​​​3.8.1 {{id name="_Toc24963760"/}}Parameters**
966 +**​​​​​​​3.8.1 {{id name="_Toc24963760"/}}Parameters**
962 962  
963 963  (% class="table-bordered" %)
964 964  |**acturl**|(% colspan="3" %)we-data/alarmdata
... ... @@ -1109,9 +1109,9 @@
1109 1109  (% style="text-align:center" %)
1110 1110  [[image:V-BOX HTTP manual_html_d4a3e0114c402c27.png||height="475" width="700" class="img-thumbnail"]]
1111 1111  
1112 -== **3.9 Get device state** ==
1117 +== **Get device state** ==
1113 1113  
1114 -**3.9.1 {{id name="_Toc24963760"/}}Parameters**
1119 +**~ {{id name="_Toc24963760"/}}Parameters**
1115 1115  
1116 1116  (% class="table-bordered" %)
1117 1117  |**acturl**|(% colspan="3" %)we-data/getDeviceState
... ... @@ -1121,7 +1121,7 @@
1121 1121  |(% rowspan="2" %)**Return value**|Field name|(% colspan="2" %)Description
1122 1122  |state|(% colspan="2" %)vbox state: 1-online,  0-offline
1123 1123  
1124 -== **3.10 Send switch to device** ==
1129 +== **Send switch to device** ==
1125 1125  
1126 1126  **3.10.1 {{id name="_Toc24963760"/}}Parameters**
1127 1127  
... ... @@ -1132,9 +1132,9 @@
1132 1132  |(% style="width:450px" %)boxId|(% colspan="2" %)boxId(required)
1133 1133  |(% rowspan="1" style="width:102px" %)**Return value**|(% style="width:450px" %)Field name|(% colspan="2" %)Description
1134 1134  
1135 -= **4 Appendix** =
1140 += **Appendix** =
1136 1136  
1137 -== (% style="color:inherit; font-family:inherit; font-size:26px" %)**4.1 Data type**(%%) ==
1142 +== (% style="color:inherit; font-family:inherit; font-size:26px" %)**Data type**(%%) ==
1138 1138  
1139 1139  100: 16-bit binary
1140 1140