Skip to Content

Changes for page 07 HTTP API

Last modified by Devin Chen on 2025/05/06 11:44
From version 19.1
edited by xingzhi lin
on 2025/04/01 11:34
Change comment: There is no comment for this version
To version 26.1
edited by Devin Chen
on 2025/05/06 11:44
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.lxz
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
... ... @@ -583,7 +583,7 @@
583 583  == **Tags data list** ==
584 584  
585 585  {{warning}}
586 -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 with this API
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
587 587  {{/warning}}
588 588  
589 589  **~ {{id name="_Toc24963744"/}}Parameters**
... ... @@ -591,11 +591,12 @@
591 591  (% class="table-bordered" %)
592 592  |**acturl**|(% colspan="3" %)we-data/realdata
593 593  |**Functions**|(% colspan="3" %)Get the tags data in the specified group in V-BOX.
594 -|(% rowspan="5" %)**Parameters**|Parameter|(% colspan="2" %)Description
595 +|(% colspan="1" rowspan="6" %)**Parameters**|Parameter|(% colspan="2" %)Description
595 595  |boxId|(% colspan="2" %)VBoxID(“None” means custom tag grouping)
596 596  |groupId|(% colspan="2" %)Group ID (Required)
597 597  |pageSize|(% colspan="2" %)Number of each page, 10 by default
598 598  |pageIndex|(% colspan="2" %)Number of current page, start from 1
600 +|devType|(% colspan="2" %)Device type (0:Box, 1:HMI)
599 599  |(% rowspan="11" %)**Return value**|Field name|(% colspan="2" %)Description
600 600  |(% rowspan="7" %)List|(% colspan="2" %)Real-time data list
601 601  |com|Communication port ID
... ... @@ -710,9 +710,11 @@
710 710  (% class="table-bordered" %)
711 711  |**acturl**|(% colspan="2" %)we-data/updrealdata
712 712  |**Functions**|(% colspan="2" %)Modify tag data
713 -|(% rowspan="3" %)**Parameters**|Parameter|Description
715 +|(% rowspan="5" %)**Parameters**|Parameter|Description
716 +|boxId|Box ID
714 714  |monitorId|Tag ID
715 715  |value|value
719 +|devType|Device type (0:Box, 1:HMI)
716 716  |**Return value**|(% colspan="2" %)None
717 717  
718 718  **Operating procedures**
... ... @@ -724,25 +724,26 @@
724 724  
725 725  **Step2:** Set parameters on Params
726 726  
727 -"monitorId":"91541"
731 +boxId:6397578
732 +monitorId:1001
733 +value:66
734 +devType:1
728 728  
729 -"value":"60"
730 -
731 731  (% style="text-align:center" %)
732 -[[image:V-BOX HTTP manual_html_5a3153add75ca7b4.png||height="246" width="800" class="img-thumbnail"]]
737 +[[image:1746502882467-849.png]]
733 733  
734 734  **Step3:** Get sign
735 735  
736 -comid=2&compvtkey=589625dce895454dbff9782c299db156&monitorId=91541&sid=2d7bfd344aa64d8ebc9beea0e4dad8ad&ts=1573897380&value=60&key=f1cd9351930d4e589922edbcf3b09a7c
741 +boxId=6397578&comid=128&compvtkey=7e421dd30a394d74b7b9c079e67e272c&devType=1&monitorId=1001&sid=d8c98edd64da40289fef565c94924fe5&ts=171746501715435&value=66&key=f1cd9351930d4e589922edbcf3b09a7c
737 737  
738 -MD5 sign: 4119b1abc9176a187f781bece04a5296
743 +MD5 sign: 4802a362fde2ca5053ad79fe4d272200
739 739  
740 740  **Step4: **Set common of header
741 741  
742 -{"monitorId":"91541","value":"60","sid":"2d7bfd344aa64d8ebc9beea0e4dad8ad","comid":"2","compvtkey":"589625dce895454dbff9782c299db156","ts":"1573897380","sign":"4119b1abc9176a187f781bece04a5296"}
747 +{"compvtkey":"7e421dd30a394d74b7b9c079e67e272c","sign":"4802a362fde2ca5053ad79fe4d272200","comid":"128","sid":"d8c98edd64da40289fef565c94924fe5","ts":171746501715435}
743 743  
744 744  (% style="text-align:center" %)
745 -[[image:V-BOX HTTP manual_html_59d54a5d886ef614.png||height="244" width="700" class="img-thumbnail"]]
750 +[[image:1746503047845-902.png]]
746 746  
747 747  **Result**
748 748  
... ... @@ -759,7 +759,7 @@
759 759  }
760 760  
761 761  (% style="text-align:center" %)
762 -[[image:V-BOX HTTP manual_html_590c8dab9e80fd0f.png||height="425" width="700" class="img-thumbnail"]]
767 +[[image:1746503002289-932.png]]
763 763  
764 764  == **Historical tags name list** ==
765 765  
... ... @@ -768,8 +768,9 @@
768 768  (% class="table-bordered" %)
769 769  |**acturl**|(% colspan="3" %)we-data/monitors
770 770  |**Functions**|(% colspan="3" %)Get a list of historical tags
771 -|(% rowspan="2" %)**Parameters**|Parameter|(% colspan="2" %)Description
772 -|boxId|(% colspan="2" %)VBoxID (Not required)
776 +|(% rowspan="3" %)**Parameters**|Parameter|(% colspan="2" %)Description
777 +|boxId|(% colspan="2" %)Box ID (Not required)
778 +|devType|(% colspan="2" %)Device type (0:Box, 1:HMI)
773 773  |(% rowspan="4" %)**Return value**|Field name|(% colspan="2" %)Description
774 774  |(% rowspan="3" %)list|(% colspan="2" %)Tag list
775 775  |monitorId|tag ID
... ... @@ -972,7 +972,7 @@
972 972  (% class="table-bordered" %)
973 973  |**acturl**|(% colspan="3" %)we-data/alarmdata
974 974  |**Function**|(% colspan="3" %)Get alarm data
975 -|(% rowspan="9" %)**Parameters**|Parameter|(% colspan="2" %)Description
981 +|(% rowspan="10" %)**Parameters**|Parameter|(% colspan="2" %)Description
976 976  |boxId|(% colspan="2" %)VBoxID, (Required)
977 977  |monitorBeginTime|(% colspan="2" %)Monitoring start time, (Not required)
978 978  |monitorEndTime|(% colspan="2" %)Monitoring end time, (Not required)
... ... @@ -989,6 +989,7 @@
989 989  
990 990  (Not necessary)
991 991  )))
998 +|devType|(% colspan="2" %)Device type (0:Box, 1:HMI)
992 992  |(% rowspan="12" %)**Return value**|Field name|(% colspan="2" %)Description
993 993  |(% rowspan="8" %)List|(% colspan="2" %)Alarm data list
994 994  |monitorId|tag ID
1746502870811-166.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.DevinChen
Size
... ... @@ -1,0 +1,1 @@
1 +36.4 KB
Content
1746502882467-849.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.DevinChen
Size
... ... @@ -1,0 +1,1 @@
1 +36.4 KB
Content
1746503002289-932.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.DevinChen
Size
... ... @@ -1,0 +1,1 @@
1 +20.3 KB
Content
1746503047845-902.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.DevinChen
Size
... ... @@ -1,0 +1,1 @@
1 +42.1 KB
Content