Skip to Content

Changes for page 07 HTTP API

Last modified by Devin Chen on 2025/05/06 11:44
From version 16.1
edited by Mora Zhou
on 2023/12/22 10:06
Change comment: There is no comment for this version
To version 25.1
edited by Devin Chen
on 2025/04/10 16:16
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Mora
1 +XWiki.DevinChen
Content
... ... @@ -427,11 +427,12 @@
427 427  (% class="table-bordered" %)
428 428  |**acturl**|(% colspan="3" %)we-data/realcfgs
429 429  |**Functions**|(% colspan="3" %)Get the tags configuration information in the specified group in V-BOX.
430 -|(% rowspan="5" %)**Parameters**|Parameter|(% colspan="2" %)Description
430 +|(% colspan="1" rowspan="6" %)**Parameters**|Parameter|(% colspan="2" %)Description
431 431  |boxId|(% colspan="2" %)VBoxID(“None” means custom tags grouping)
432 432  |groupId|(% colspan="2" %)Group ID (Required)
433 433  |pageSize|(% colspan="2" %)Number of each page, 10 by default
434 434  |pageIndex|(% colspan="2" %)Number of current page, start from 1
435 +|devType|(% colspan="2" %)Device type (0:Box, 1:HMI)
435 435  |(% rowspan="15" %)**Return value**|Field name|(% colspan="2" %)Description
436 436  |(% rowspan="11" %)cfgList|monitorId|Tags ID
437 437  |monitorName|Tags name
... ... @@ -582,16 +582,21 @@
582 582  
583 583  == **Tags data list** ==
584 584  
586 +{{warning}}
587 +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
588 +{{/warning}}
589 +
585 585  **~ {{id name="_Toc24963744"/}}Parameters**
586 586  
587 587  (% class="table-bordered" %)
588 588  |**acturl**|(% colspan="3" %)we-data/realdata
589 589  |**Functions**|(% colspan="3" %)Get the tags data in the specified group in V-BOX.
590 -|(% rowspan="5" %)**Parameters**|Parameter|(% colspan="2" %)Description
595 +|(% colspan="1" rowspan="6" %)**Parameters**|Parameter|(% colspan="2" %)Description
591 591  |boxId|(% colspan="2" %)VBoxID(“None” means custom tag grouping)
592 592  |groupId|(% colspan="2" %)Group ID (Required)
593 593  |pageSize|(% colspan="2" %)Number of each page, 10 by default
594 594  |pageIndex|(% colspan="2" %)Number of current page, start from 1
600 +|devType|(% colspan="2" %)Device type (0:Box, 1:HMI)
595 595  |(% rowspan="11" %)**Return value**|Field name|(% colspan="2" %)Description
596 596  |(% rowspan="7" %)List|(% colspan="2" %)Real-time data list
597 597  |com|Communication port ID
... ... @@ -706,9 +706,11 @@
706 706  (% class="table-bordered" %)
707 707  |**acturl**|(% colspan="2" %)we-data/updrealdata
708 708  |**Functions**|(% colspan="2" %)Modify tag data
709 -|(% rowspan="3" %)**Parameters**|Parameter|Description
715 +|(% rowspan="5" %)**Parameters**|Parameter|Description
716 +|boxId|Box ID
710 710  |monitorId|Tag ID
711 711  |value|value
719 +|devType|Device type (0:Box, 1:HMI)
712 712  |**Return value**|(% colspan="2" %)None
713 713  
714 714  **Operating procedures**
... ... @@ -757,7 +757,7 @@
757 757  (% style="text-align:center" %)
758 758  [[image:V-BOX HTTP manual_html_590c8dab9e80fd0f.png||height="425" width="700" class="img-thumbnail"]]
759 759  
760 -== ** {{id name="_Toc24963751"/}}Historical tags name list** ==
768 +== **Historical tags name list** ==
761 761  
762 762  **Parameters**
763 763  
... ... @@ -764,8 +764,9 @@
764 764  (% class="table-bordered" %)
765 765  |**acturl**|(% colspan="3" %)we-data/monitors
766 766  |**Functions**|(% colspan="3" %)Get a list of historical tags
767 -|(% rowspan="2" %)**Parameters**|Parameter|(% colspan="2" %)Description
768 -|boxId|(% colspan="2" %)VBoxID (Not required)
775 +|(% rowspan="3" %)**Parameters**|Parameter|(% colspan="2" %)Description
776 +|boxId|(% colspan="2" %)Box ID (Not required)
777 +|devType|(% colspan="2" %)Device type (0:Box, 1:HMI)
769 769  |(% rowspan="4" %)**Return value**|Field name|(% colspan="2" %)Description
770 770  |(% rowspan="3" %)list|(% colspan="2" %)Tag list
771 771  |monitorId|tag ID
... ... @@ -841,7 +841,7 @@
841 841  (% style="text-align:center" %)
842 842  [[image:V-BOX HTTP manual_html_2a739377a9fb10b2.png||height="400" width="700" class="img-thumbnail"]]
843 843  
844 -== ** {{id name="_Toc24963755"/}}Historical tag data list** ==
853 +== **Historical tag data list** ==
845 845  
846 846  **~ {{id name="_Toc24963756"/}}Parameters**
847 847  
... ... @@ -968,7 +968,7 @@
968 968  (% class="table-bordered" %)
969 969  |**acturl**|(% colspan="3" %)we-data/alarmdata
970 970  |**Function**|(% colspan="3" %)Get alarm data
971 -|(% rowspan="9" %)**Parameters**|Parameter|(% colspan="2" %)Description
980 +|(% rowspan="10" %)**Parameters**|Parameter|(% colspan="2" %)Description
972 972  |boxId|(% colspan="2" %)VBoxID, (Required)
973 973  |monitorBeginTime|(% colspan="2" %)Monitoring start time, (Not required)
974 974  |monitorEndTime|(% colspan="2" %)Monitoring end time, (Not required)
... ... @@ -985,6 +985,7 @@
985 985  
986 986  (Not necessary)
987 987  )))
997 +|devType|(% colspan="2" %)Device type (0:Box, 1:HMI)
988 988  |(% rowspan="12" %)**Return value**|Field name|(% colspan="2" %)Description
989 989  |(% rowspan="8" %)List|(% colspan="2" %)Alarm data list
990 990  |monitorId|tag ID