Changes for page 07 HTTP API

Last modified by Devin Chen on 2025/04/10 16:16

From 11.1 to 12.1 From 16.1 to 17.1

From version 12.1

edited by Hunter
on 2023/08/03 15:02

Change comment: Replaced user [xwiki:XWiki.hunter123] in fields [author, contentAuthor] to user [xwiki:XWiki.Hunter]

To version 16.1

edited by Mora Zhou
on 2023/12/22 10:06

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (3 modified, 0 added, 0 removed)

Details

Page properties

Title

@@ -1,1 +1,1 @@
--7 HTTP API
++07 HTTP API

Author

@@ -1,1 +1,1 @@
--XWiki.Hunter
++XWiki.Mora

Content

@@ -1,4 +1,4 @@
--= **1 General** =
++= **General** =
  This documents introduces WECON V-BOX HTTP API. And this document also shows some examples. All example is tested from postman application.
@@ -43,9 +43,12 @@
  screctkey=f1cd9351930d4e589922edbcf3b09a7c
++(% class="box infomessage" %)
++(((
  **✎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)
++)))
--== **1.1 Interface Parameter Description** ==
++== **Interface Parameter Description** ==
  **Global parameters**
@@ -69,7 +69,7 @@
  (% style="text-align:center" %)
  [[image:1.png||height="141" width="500" class="img-thumbnail"]]
--== **1.2 Example key and value** ==
++== **Example key and value** ==
 ).**comid**=2
@@ -80,10 +80,10 @@
 ).**ts**=1573897380
  (((
--= **2 Basic API** =
++= **Basic API** =
  )))
--== **2.1 {{id name="_Toc24963726"/}}Login operation** ==
++== **{{id name="_Toc24963726"/}}Login operation** ==
  (((
  **2.1.1 Parameters**
@@ -100,7 +100,7 @@
  |utype|(% style="width:535px" %)User Type: 1-Manage Account, 2-Viewer Account
  |sid|(% style="width:535px" %)User session ID (Only available for 12 hours)
--**2.1.2 Operating procedures**
++**Operating procedures**
  **Setp1: ** Set http: [[http:~~/~~/api.v-box.net/box-data/api/we-data/login>>url:http://api.v-box.net/box-data/api/we-data/login]]
@@ -140,7 +140,7 @@
  [[image:V-BOX HTTP manual_html_cbfc9bbb7d0d4f84.png||height="230" width="700" class="img-thumbnail"]]
  (((
--**2.1.3 Result**
++**Result**
  )))
  {
@@ -167,17 +167,17 @@
  [[image:V-BOX HTTP manual_html_b00e7e6a00828e27.png||height="291" width="500" class="img-thumbnail"]]
  (((
--= **3 Service data APIs** =
++= **Service data APIs** =
  )))
--== **3.1 V-Box list** ==
++== **V-Box list** ==
--**3.1.1 {{id name="_Toc24963732"/}}Parameters**
++**{{id name="_Toc24963732"/}}Parameters**
  (% style="text-align:center" %)
  [[image:X.png||height="412" width="700" class="img-thumbnail"]]
--**3.1.2 {{id name="_Toc24963733"/}}Operating procedures**
++**~ {{id name="_Toc24963733"/}}Operating procedures**
  **Step1:**  Set http: [[http:~~/~~/api.v-box.net/box-data/api/we-data/boxs>>url:http://api.v-box.net/box-data/api/we-data/boxs]]
@@ -201,7 +201,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_999832f3a31ac851.png||height="232" width="700" class="img-thumbnail"]]
--**3.1.3 Result**
++**Result**
  {
@@ -330,9 +330,9 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_5999b14ed63e8065.png||height="348" width="600" class="img-thumbnail"]]
--== **3.2 Real-time group list** ==
++== **Real-time group list** ==
--**3.2.1{{id name="_Toc24963736"/}} Parameters**
++**{{id name="_Toc24963736"/}} Parameters**
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/realgroups
@@ -344,7 +344,7 @@
  |groupId|Group ID
  |groupName|Group name
--**3.2.2 Operating procedures**
++**Operating procedures**
  **Step1: **Set http: [[http:~~/~~/api.v-box.net/box-data/api/we-data/realgroups>>url:http://api.v-box.net/box-data/api/we-data/realgroups]]
@@ -371,7 +371,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_cc06cac462c1b77a.png||height="172" width="800" class="img-thumbnail"]]
--**3.2.3 Result**
++**Result**
  {
@@ -417,9 +417,9 @@
  [[image:V-BOX HTTP manual_html_2445c358293d621.png||height="531" width="532"]]
--== **3.3 Real-time tags configuration list** ==
++== **Real-time tags configuration list** ==
--**3.3.1 Parameters**
++**Parameters**
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/realcfgs
@@ -461,7 +461,7 @@
  |totalRecord|(% colspan="2" %)Total record number
  |currentPage|(% colspan="2" %)Current page number
--**3.3.2 Operating procedures**
++**Operating procedures**
  **Step1: **Set http: [[http:~~/~~/api.v-box.net/box-data/api/we-data/realcfgs>>url:http://api.v-box.net/box-data/api/we-data/realcfgs]]
@@ -494,7 +494,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_d284dfdd7b4844ee.png||height="288" width="800" class="img-thumbnail"]]
--**3.3.3 Result**
++**Result**
  {
@@ -577,9 +577,9 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_e7271097b71941cc.png||height="644" width="800" class="img-thumbnail"]]
--== (% id="cke_bm_1151S" style="display:none" %)** {{id name="_Toc24963743"/}}**(%%)**3.4 Tags data list** ==
++== **Tags data list** ==
--**3.4.1 {{id name="_Toc24963744"/}}Parameters**
++**~ {{id name="_Toc24963744"/}}Parameters**
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/realdata
@@ -601,7 +601,7 @@
  |totalRecord|(% colspan="2" %)Total record
  |currentPage|(% colspan="2" %)current page
--**3.4.2 {{id name="_Toc24963745"/}}Operating procedures**
++**~ {{id name="_Toc24963745"/}}Operating procedures**
  **Step1: **Set http: [[http:~~/~~/api.v-box.net/box-data/api/we-data/realdata>>url:http://api.v-box.net/box-data/api/we-data/realdata]]
@@ -629,7 +629,7 @@
  {"boxId":"973","groupId":"7325","pageSize":"5","pageIndex":"2","sid":"2d7bfd344aa64d8ebc9beea0e4dad8ad","comid":"2","compvtkey":"589625dce895454dbff9782c299db156","ts":"1573897380","sign":"0769228e66c945eed5431c41a96949f2"}
--**3.4.3 {{id name="_Toc24963746"/}}Result**
++**~ {{id name="_Toc24963746"/}}Result**
  {
@@ -694,10 +694,10 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_705682e81eae5ea7.png||height="651" width="800" class="img-thumbnail"]]
--== **3.5 Modify tag data** ==
++== **Modify tag data** ==
  (((
--**3.5.1 Parameters**
++**Parameters**
  )))
  (% class="table-bordered" %)
@@ -708,7 +708,7 @@
  |value|value
  |**Return value**|(% colspan="2" %)None
--**3.5.2 Operating procedures**
++**Operating procedures**
  **Step1:** Set http: [[http:~~/~~/api.v-box.net/box-data/api/we-data/updrealdata>>url:http://api.v-box.net/box-data/api/we-data/updrealdata]]
@@ -737,7 +737,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_59d54a5d886ef614.png||height="244" width="700" class="img-thumbnail"]]
--**3.5.3 Result**
++**Result**
  {
@@ -754,9 +754,9 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_590c8dab9e80fd0f.png||height="425" width="700" class="img-thumbnail"]]
--== **3.6 {{id name="_Toc24963751"/}}Historical tags name list** ==
++== ** {{id name="_Toc24963751"/}}Historical tags name list** ==
--**3.6.1 Parameters**
++**Parameters**
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/monitors
@@ -768,7 +768,7 @@
  |monitorId|tag ID
  |monitorName|tag name
--**3.6.2 Operating procedures**
++**Operating procedures**
  **Step1: **Set http: [[http:~~/~~/api.v-box.net/box-data/api/we-data/monitors>>url:http://api.v-box.net/box-data/api/we-data/monitors]]
@@ -795,7 +795,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_dba52ac718eeb66e.png||height="228" width="700" class="img-thumbnail"]]
--**3.6.3 Result**
++**Result**
  {
@@ -838,9 +838,9 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_2a739377a9fb10b2.png||height="400" width="700" class="img-thumbnail"]]
--== (% id="cke_bm_1218S" style="display:none" %)** **(%%)**3.7 {{id name="_Toc24963755"/}}Historical tag data list** ==
++== ** {{id name="_Toc24963755"/}}Historical tag data list** ==
--**3.7.1 {{id name="_Toc24963756"/}}Parameters**
++**~ {{id name="_Toc24963756"/}}Parameters**
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/historydata
@@ -860,7 +860,7 @@
  |totalRecord|(% colspan="2" %)Total records
  |currentPage|(% colspan="2" %)Current page
--**3.7.2 Operating procedures**
++**Operating procedures**
  **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]]
@@ -895,7 +895,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_fac48b1179b555ee.png||height="291" width="700" class="img-thumbnail"]]
--**3.7.3 Result**
++**Result**
  {
@@ -958,9 +958,9 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_f3b62eb69687a214.png||height="476" width="700" class="img-thumbnail"]]
--== **3.8 Alarm tags data list** ==
++== **Alarm tags data list** ==
--**3.8.1 {{id name="_Toc24963760"/}}Parameters**
++**{{id name="_Toc24963760"/}}Parameters**
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/alarmdata
@@ -995,7 +995,7 @@
  |totalRecord|(% colspan="2" %)Total records
  |currentPage|(% colspan="2" %)Current page
--**3.8.2 {{id name="_Toc24963761"/}}Operating procedures**
++**~ {{id name="_Toc24963761"/}}Operating procedures**
  **Step1:** Set http: [[http:~~/~~/api.v-box.net/box-data/api/we-data/alarmdata>>url:http://api.v-box.net/box-data/api/we-data/alarmdata]]
@@ -1032,7 +1032,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_cd9ce84648b86cb9.png||height="269" width="700" class="img-thumbnail"]]
--**3.8.3 Result**
++**Result**
  {
@@ -1111,9 +1111,9 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_d4a3e0114c402c27.png||height="475" width="700" class="img-thumbnail"]]
--== **3.9 Get device state** ==
++== **Get device state** ==
--**3.9.1 {{id name="_Toc24963760"/}}Parameters**
++**~ {{id name="_Toc24963760"/}}Parameters**
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/getDeviceState
@@ -1123,7 +1123,7 @@
  |(% rowspan="2" %)**Return value**|Field name|(% colspan="2" %)Description
  |state|(% colspan="2" %)vbox state: 1-online,  0-offline
--== **3.10 Send switch to device** ==
++== **Send switch to device** ==
  **3.10.1 {{id name="_Toc24963760"/}}Parameters**
@@ -1134,9 +1134,9 @@
  |(% style="width:450px" %)boxId|(% colspan="2" %)boxId(required)
  |(% rowspan="1" style="width:102px" %)**Return value**|(% style="width:450px" %)Field name|(% colspan="2" %)Description
--= **4 Appendix** =
++= **Appendix** =
--== (% style="color:inherit; font-family:inherit; font-size:26px" %)**4.1 Data type**(%%) ==
++== (% style="color:inherit; font-family:inherit; font-size:26px" %)**Data type**(%%) ==
 : 16-bit binary

Changes for page 07 HTTP API

Summary

Details

Navigation

Table of Contents