Changes for page 07 HTTP API

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

From 15.1 to 14.1 From 21.1 to 20.1

From version 20.1

edited by Devin Chen
on 2025/04/01 11:49

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

Raw
Rendered

Summary

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

Details

Page properties

Author

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

Content

@@ -1,4 +1,4 @@
--= **General** =
++= **1 General** =
  This documents introduces WECON V-BOX HTTP API. And this document also shows some examples. All example is tested from postman application.
@@ -48,7 +48,7 @@
  **✎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)
  )))
--== **Interface Parameter Description** ==
++== **1.1 Interface Parameter Description** ==
  **Global parameters**
@@ -72,7 +72,7 @@
  (% style="text-align:center" %)
  [[image:1.png||height="141" width="500" class="img-thumbnail"]]
--== **Example key and value** ==
++== **1.2 Example key and value** ==
 ).**comid**=2
@@ -83,10 +83,10 @@
 ).**ts**=1573897380
  (((
--= **Basic API** =
++= **2 Basic API** =
  )))
--== **{{id name="_Toc24963726"/}}Login operation** ==
++== **2.1 {{id name="_Toc24963726"/}}Login operation** ==
  (((
  **2.1.1 Parameters**
@@ -103,7 +103,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)
--**Operating procedures**
++**2.1.2 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]]
@@ -143,7 +143,7 @@
  [[image:V-BOX HTTP manual_html_cbfc9bbb7d0d4f84.png||height="230" width="700" class="img-thumbnail"]]
  (((
--**Result**
++**2.1.3 Result**
  )))
  {
@@ -170,17 +170,17 @@
  [[image:V-BOX HTTP manual_html_b00e7e6a00828e27.png||height="291" width="500" class="img-thumbnail"]]
  (((
--= **Service data APIs** =
++= **3 Service data APIs** =
  )))
--== **V-Box list** ==
++== **3.1 V-Box list** ==
--**{{id name="_Toc24963732"/}}Parameters**
++**3.1.1 {{id name="_Toc24963732"/}}Parameters**
  (% style="text-align:center" %)
  [[image:X.png||height="412" width="700" class="img-thumbnail"]]
--**~ {{id name="_Toc24963733"/}}Operating procedures**
++**3.1.2 {{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]]
@@ -204,7 +204,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_999832f3a31ac851.png||height="232" width="700" class="img-thumbnail"]]
--**Result**
++**3.1.3 Result**
  {
@@ -333,9 +333,9 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_5999b14ed63e8065.png||height="348" width="600" class="img-thumbnail"]]
--== **Real-time group list** ==
++== **3.2 Real-time group list** ==
--**{{id name="_Toc24963736"/}} Parameters**
++**3.2.1{{id name="_Toc24963736"/}} Parameters**
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/realgroups
@@ -347,7 +347,7 @@
  |groupId|Group ID
  |groupName|Group name
--**Operating procedures**
++**3.2.2 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]]
@@ -374,7 +374,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_cc06cac462c1b77a.png||height="172" width="800" class="img-thumbnail"]]
--**Result**
++**3.2.3 Result**
  {
@@ -420,9 +420,9 @@
  [[image:V-BOX HTTP manual_html_2445c358293d621.png||height="531" width="532"]]
--== **Real-time tags configuration list** ==
++== **3.3 Real-time tags configuration list** ==
--**Parameters**
++**3.3.1 Parameters**
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/realcfgs
@@ -464,7 +464,7 @@
  |totalRecord|(% colspan="2" %)Total record number
  |currentPage|(% colspan="2" %)Current page number
--**Operating procedures**
++**3.3.2 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]]
@@ -497,7 +497,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_d284dfdd7b4844ee.png||height="288" width="800" class="img-thumbnail"]]
--**Result**
++**3.3.3 Result**
  {
@@ -580,14 +580,10 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_e7271097b71941cc.png||height="644" width="800" class="img-thumbnail"]]
--== **Tags data list** ==
++== (% id="cke_bm_1151S" style="display:none" %)** {{id name="_Toc24963743"/}}**(%%)**3.4 Tags data list** ==
--{{warning}}
--This API is not for getting the real-time data all the time.If you need to get the continuously updated real-time monitoring point data values,you need to use **[[Send switch to device>>https://docs.we-con.com.cn/bin/view/V-BOX/V-Net/Manual/6%20HTTP%20API/#HSendswitchtodevice]] **API with this API
--{{/warning}}
++**3.4.1 {{id name="_Toc24963744"/}}Parameters**
--**~ {{id name="_Toc24963744"/}}Parameters**
--
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/realdata
  |**Functions**|(% colspan="3" %)Get the tags data in the specified group in V-BOX.
@@ -608,7 +608,7 @@
  |totalRecord|(% colspan="2" %)Total record
  |currentPage|(% colspan="2" %)current page
--**~ {{id name="_Toc24963745"/}}Operating procedures**
++**3.4.2 {{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]]
@@ -636,7 +636,7 @@
  {"boxId":"973","groupId":"7325","pageSize":"5","pageIndex":"2","sid":"2d7bfd344aa64d8ebc9beea0e4dad8ad","comid":"2","compvtkey":"589625dce895454dbff9782c299db156","ts":"1573897380","sign":"0769228e66c945eed5431c41a96949f2"}
--**~ {{id name="_Toc24963746"/}}Result**
++**3.4.3 {{id name="_Toc24963746"/}}Result**
  {
@@ -701,10 +701,10 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_705682e81eae5ea7.png||height="651" width="800" class="img-thumbnail"]]
--== **Modify tag data** ==
++== **3.5 Modify tag data** ==
  (((
--**Parameters**
++**3.5.1 Parameters**
  )))
  (% class="table-bordered" %)
@@ -715,7 +715,7 @@
  |value|value
  |**Return value**|(% colspan="2" %)None
--**Operating procedures**
++**3.5.2 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]]
@@ -744,7 +744,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_59d54a5d886ef614.png||height="244" width="700" class="img-thumbnail"]]
--**Result**
++**3.5.3 Result**
  {
@@ -761,9 +761,9 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_590c8dab9e80fd0f.png||height="425" width="700" class="img-thumbnail"]]
--== **Historical tags name list** ==
++== **3.6 {{id name="_Toc24963751"/}}Historical tags name list** ==
--**Parameters**
++**3.6.1 Parameters**
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/monitors
@@ -775,7 +775,7 @@
  |monitorId|tag ID
  |monitorName|tag name
--**Operating procedures**
++**3.6.2 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]]
@@ -802,7 +802,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_dba52ac718eeb66e.png||height="228" width="700" class="img-thumbnail"]]
--**Result**
++**3.6.3 Result**
  {
@@ -845,9 +845,9 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_2a739377a9fb10b2.png||height="400" width="700" class="img-thumbnail"]]
--== **Historical tag data list** ==
++== (% id="cke_bm_1218S" style="display:none" %)** **(%%)**3.7 {{id name="_Toc24963755"/}}Historical tag data list** ==
--**~ {{id name="_Toc24963756"/}}Parameters**
++**3.7.1 {{id name="_Toc24963756"/}}Parameters**
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/historydata
@@ -867,7 +867,7 @@
  |totalRecord|(% colspan="2" %)Total records
  |currentPage|(% colspan="2" %)Current page
--**Operating procedures**
++**3.7.2 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]]
@@ -902,7 +902,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_fac48b1179b555ee.png||height="291" width="700" class="img-thumbnail"]]
--**Result**
++**3.7.3 Result**
  {
@@ -965,9 +965,9 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_f3b62eb69687a214.png||height="476" width="700" class="img-thumbnail"]]
--== **Alarm tags data list** ==
++== **3.8 Alarm tags data list** ==
--**{{id name="_Toc24963760"/}}Parameters**
++**3.8.1 {{id name="_Toc24963760"/}}Parameters**
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/alarmdata
@@ -1002,7 +1002,7 @@
  |totalRecord|(% colspan="2" %)Total records
  |currentPage|(% colspan="2" %)Current page
--**~ {{id name="_Toc24963761"/}}Operating procedures**
++**3.8.2 {{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]]
@@ -1039,7 +1039,7 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_cd9ce84648b86cb9.png||height="269" width="700" class="img-thumbnail"]]
--**Result**
++**3.8.3 Result**
  {

Changes for page 07 HTTP API

Summary

Details

Navigation

Table of Contents