Changes for page 07 HTTP API

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

From 14.1 to 13.1 From 22.1 to 21.1

From version 21.1

edited by Devin Chen
on 2025/04/10 13:45

Change comment: There is no comment for this version

To version 14.1

edited by Mora Zhou
on 2023/11/22 13:54

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
@@ -432,7 +432,6 @@
  |groupId|(% colspan="2" %)Group ID (Required)
  |pageSize|(% colspan="2" %)Number of each page, 10 by default
  |pageIndex|(% colspan="2" %)Number of current page, start from 1
--| |devType|(% colspan="2" %)Device type（0:Box，1:HMI）
  |(% rowspan="15" %)**Return value**|Field name|(% colspan="2" %)Description
  |(% rowspan="11" %)cfgList|monitorId|Tags ID
  |monitorName|Tags name
@@ -465,7 +465,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]]
@@ -498,7 +498,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**
  {
@@ -581,14 +581,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.
@@ -609,7 +609,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]]
@@ -637,7 +637,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**
  {
@@ -702,10 +702,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" %)
@@ -716,7 +716,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]]
@@ -745,7 +745,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**
  {
@@ -762,9 +762,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
@@ -776,7 +776,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]]
@@ -803,7 +803,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**
  {
@@ -846,9 +846,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
@@ -868,7 +868,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]]
@@ -903,7 +903,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**
  {
@@ -966,9 +966,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
@@ -1003,7 +1003,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]]
@@ -1040,7 +1040,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**
  {
@@ -1119,9 +1119,9 @@
  (% style="text-align:center" %)
  [[image:V-BOX HTTP manual_html_d4a3e0114c402c27.png||height="475" width="700" class="img-thumbnail"]]
--== **Get device state** ==
++== **3.9 Get device state** ==
--**~ {{id name="_Toc24963760"/}}Parameters**
++**3.9.1 {{id name="_Toc24963760"/}}Parameters**
  (% class="table-bordered" %)
  |**acturl**|(% colspan="3" %)we-data/getDeviceState
@@ -1131,7 +1131,7 @@
  |(% rowspan="2" %)**Return value**|Field name|(% colspan="2" %)Description
  |state|(% colspan="2" %)vbox state: 1-online,  0-offline
--== **Send switch to device** ==
++== **3.10 Send switch to device** ==
  **3.10.1 {{id name="_Toc24963760"/}}Parameters**
@@ -1142,9 +1142,9 @@
  |(% style="width:450px" %)boxId|(% colspan="2" %)boxId(required)
  |(% rowspan="1" style="width:102px" %)**Return value**|(% style="width:450px" %)Field name|(% colspan="2" %)Description
--= **Appendix** =
++= **4 Appendix** =
--== (% style="color:inherit; font-family:inherit; font-size:26px" %)**Data type**(%%) ==
++== (% style="color:inherit; font-family:inherit; font-size:26px" %)**4.1 Data type**(%%) ==
 : 16-bit binary

Changes for page 07 HTTP API

Summary

Details

Navigation

Table of Contents