Skip to Content

Changes for page 07 HTTP API

Last modified by Devin Chen on 2025/06/30 14:16
From version 8.1
edited by Hunter
on 2023/01/11 18:56
Change comment: There is no comment for this version
To version 29.1
edited by Devin Chen
on 2025/06/30 14:16
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -7 HTTP API
1 +07 HTTP API
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Hunter
1 +XWiki.DevinChen
Content
... ... @@ -1,4 +1,4 @@
1 -= **1 General** =
1 += **General** =
2 2  
3 3  This documents introduces WECON V-BOX HTTP API. And this document also shows some examples. All example is tested from postman application.
4 4  
... ... @@ -25,9 +25,9 @@
25 25  
26 26  The common KEY is:
27 27  
28 -**comid=2**
28 +**comid=128**
29 29  
30 -**comkey=589625dce895454dbff9782c299db156**
30 +**comkey=7e421dd30a394d74b7b9c079e67e272c**
31 31  
32 32  screctkey=f1cd9351930d4e589922edbcf3b09a7c
33 33  
... ... @@ -43,9 +43,12 @@
43 43  
44 44  screctkey=f1cd9351930d4e589922edbcf3b09a7c
45 45  
46 +(% class="box infomessage" %)
47 +(((
46 46  **✎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)
49 +)))
47 47  
48 -== **1.1 Interface Parameter Description** ==
51 +== **Interface Parameter Description** ==
49 49  
50 50  **Global parameters**
51 51  
... ... @@ -69,7 +69,7 @@
69 69  (% style="text-align:center" %)
70 70  [[image:1.png||height="141" width="500" class="img-thumbnail"]]
71 71  
72 -== **1.2 Example key and value** ==
75 +== **Example key and value** ==
73 73  
74 74  1).**comid**=2
75 75  
... ... @@ -80,10 +80,10 @@
80 80  4).**ts**=1573897380
81 81  
82 82  (((
83 -= **2 Basic API** =
86 += **Basic API** =
84 84  )))
85 85  
86 -== **2.1 {{id name="_Toc24963726"/}}Login operation** ==
89 +== **{{id name="_Toc24963726"/}}Login operation** ==
87 87  
88 88  (((
89 89  **2.1.1 Parameters**
... ... @@ -98,9 +98,9 @@
98 98  |domain(Optional)|(% style="width:535px" %)3rd party interface domain(Only available for Virtual Deployment)
99 99  |(% rowspan="3" %)**Return value**|Items|(% style="width:535px" %)Description
100 100  |utype|(% style="width:535px" %)User Type: 1-Manage Account, 2-Viewer Account
101 -|sid|(% style="width:535px" %)User session ID
104 +|sid|(% style="width:535px" %)User session ID (Only available for 12 hours)
102 102  
103 -**2.1.2 Operating procedures**
106 +**Operating procedures**
104 104  
105 105  **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]]
106 106  
... ... @@ -124,11 +124,13 @@
124 124  
125 125  "sign":"997513ff1320862f0cbb9ce19d0bd253"
126 126  
130 +{{info}}
127 127  **✎Note: **For Virtual Deployment, the sign string should be append with domain, so the format would be like following:
128 128  
129 129  alias=xxx&comid=xxx&compvtkey=xxx&domain=xxx&password=xxx&ts=1657682972386&key=f1cd9351930d4e589922edbcf3b09a7c
130 130  
131 131  The timestamp must be unit as Millisecond level
136 +{{/info}}
132 132  
133 133  **Step4: ** Set common of header
134 134  
... ... @@ -138,7 +138,7 @@
138 138  [[image:V-BOX HTTP manual_html_cbfc9bbb7d0d4f84.png||height="230" width="700" class="img-thumbnail"]]
139 139  
140 140  (((
141 -**2.1.3 Result**
146 +**Result**
142 142  )))
143 143  
144 144  {
... ... @@ -165,17 +165,17 @@
165 165  [[image:V-BOX HTTP manual_html_b00e7e6a00828e27.png||height="291" width="500" class="img-thumbnail"]]
166 166  
167 167  (((
168 -= **3 Service data APIs** =
173 += **Service data APIs** =
169 169  )))
170 170  
171 -== **3.1 V-Box list** ==
176 +== **V-Box list** ==
172 172  
173 -**3.1.1 {{id name="_Toc24963732"/}}Parameters**
178 +**{{id name="_Toc24963732"/}}Parameters**
174 174  
175 175  (% style="text-align:center" %)
176 176  [[image:X.png||height="412" width="700" class="img-thumbnail"]]
177 177  
178 -**3.1.2 {{id name="_Toc24963733"/}}Operating procedures**
183 +**~ {{id name="_Toc24963733"/}}Operating procedures**
179 179  
180 180  **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]]
181 181  
... ... @@ -199,7 +199,7 @@
199 199  (% style="text-align:center" %)
200 200  [[image:V-BOX HTTP manual_html_999832f3a31ac851.png||height="232" width="700" class="img-thumbnail"]]
201 201  
202 -**3.1.3 Result**
207 +**Result**
203 203  
204 204  {
205 205  
... ... @@ -328,9 +328,9 @@
328 328  (% style="text-align:center" %)
329 329  [[image:V-BOX HTTP manual_html_5999b14ed63e8065.png||height="348" width="600" class="img-thumbnail"]]
330 330  
331 -== **3.2 Real-time group list** ==
336 +== **Real-time group list** ==
332 332  
333 -**3.2.1{{id name="_Toc24963736"/}} Parameters**
338 +**{{id name="_Toc24963736"/}} Parameters**
334 334  
335 335  (% class="table-bordered" %)
336 336  |**acturl**|(% colspan="3" %)we-data/realgroups
... ... @@ -342,7 +342,7 @@
342 342  |groupId|Group ID
343 343  |groupName|Group name
344 344  
345 -**3.2.2 Operating procedures**
350 +**Operating procedures**
346 346  
347 347  **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]]
348 348  
... ... @@ -369,7 +369,7 @@
369 369  (% style="text-align:center" %)
370 370  [[image:V-BOX HTTP manual_html_cc06cac462c1b77a.png||height="172" width="800" class="img-thumbnail"]]
371 371  
372 -**3.2.3 Result**
377 +**Result**
373 373  
374 374  {
375 375  
... ... @@ -415,18 +415,19 @@
415 415  
416 416  [[image:V-BOX HTTP manual_html_2445c358293d621.png||height="531" width="532"]]
417 417  
418 -== **3.3 Real-time tags configuration list** ==
423 +== **Real-time tags configuration list** ==
419 419  
420 -**3.3.1 Parameters**
425 +**Parameters**
421 421  
422 422  (% class="table-bordered" %)
423 423  |**acturl**|(% colspan="3" %)we-data/realcfgs
424 424  |**Functions**|(% colspan="3" %)Get the tags configuration information in the specified group in V-BOX.
425 -|(% rowspan="5" %)**Parameters**|Parameter|(% colspan="2" %)Description
430 +|(% colspan="1" rowspan="6" %)**Parameters**|Parameter|(% colspan="2" %)Description
426 426  |boxId|(% colspan="2" %)VBoxID(“None” means custom tags grouping)
427 427  |groupId|(% colspan="2" %)Group ID (Required)
428 428  |pageSize|(% colspan="2" %)Number of each page, 10 by default
429 429  |pageIndex|(% colspan="2" %)Number of current page, start from 1
435 +|devType|(% colspan="2" %)Device type (0:Box, 1:HMI)
430 430  |(% rowspan="15" %)**Return value**|Field name|(% colspan="2" %)Description
431 431  |(% rowspan="11" %)cfgList|monitorId|Tags ID
432 432  |monitorName|Tags name
... ... @@ -459,7 +459,7 @@
459 459  |totalRecord|(% colspan="2" %)Total record number
460 460  |currentPage|(% colspan="2" %)Current page number
461 461  
462 -**3.3.2 Operating procedures**
468 +**Operating procedures**
463 463  
464 464  **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]]
465 465  
... ... @@ -472,101 +472,185 @@
472 472  
473 473  "groupId":"7325"
474 474  
481 +"devType":"0"
482 +
475 475  "pageSize":"5"
476 476  
477 477  "pageIndex":"2"
478 478  
479 479  (% style="text-align:center" %)
480 -[[image:V-BOX HTTP manual_html_52bf7d95165a3e3a.png||height="273" width="700" class="img-thumbnail"]]
488 +[[image:1751263596452-675.png||height="222" width="555"]]
481 481  
482 482  **Step3:** Get sign
483 483  
484 -boxId=973&comid=2&compvtkey=589625dce895454dbff9782c299db156&groupId=7325&pageIndex=2&pageSize=5&sid=2d7bfd344aa64d8ebc9beea0e4dad8ad&ts=1573897380&key=f1cd9351930d4e589922edbcf3b09a7c
492 +boxId=763&comid=128&compvtkey=7e421dd30a394d74b7b9c079e67e272c&devType=0&groupId=211608&pageIndex=1&pageSize=5&sid=0e583b1f48cf467bbf738365b3da1a26&ts=1751263335125&key=f1cd9351930d4e589922edbcf3b09a7c
485 485  
486 -MD5 sign: 0769228e66c945eed5431c41a96949f2
494 +MD5 sign: 27a89c93a4990d0497a8bd47dea4aed3
487 487  
488 488  **Step4:** Set common of header
489 489  
490 -{"boxId":"973","groupId":"7325","pageSize":"5","pageIndex":"2","sid":"2d7bfd344aa64d8ebc9beea0e4dad8ad","comid":"2","compvtkey":"589625dce895454dbff9782c299db156","ts":"1573897380","sign":"0769228e66c945eed5431c41a96949f2"}
498 +{"compvtkey":"7e421dd30a394d74b7b9c079e67e272c","sign":"27a89c93a4990d0497a8bd47dea4aed3","comid":"128","sid":"0e583b1f48cf467bbf738365b3da1a26","ts":1751263335125}
491 491  
492 492  (% style="text-align:center" %)
493 -[[image:V-BOX HTTP manual_html_d284dfdd7b4844ee.png||height="288" width="800" class="img-thumbnail"]]
501 +[[image:1751263680622-643.png]]
494 494  
495 -**3.3.3 Result**
503 +**Result**
496 496  
497 497  {
498 498  
499 - "code": 200,
507 + "code": 200,
500 500  
501 - "msg": "ok",
509 + "msg": "ok",
502 502  
503 - "reqId": "1573903822419",
511 + "reqId": "1751263500705",
504 504  
505 - "result": {
513 + "result": {
506 506  
507 - "cfgList": [
515 + "cfgList": [
508 508  
509 509   {
510 510  
511 - "monitorId": 91545,
519 + "monitorId": 2276374,
512 512  
513 - "dataId": 105,
521 + "monitorName": "x0",
514 514  
515 - "monitorName": "Temp_9",
523 + "digitBinary": "",
516 516  
517 - "updTime": 1571965761000,
525 + "float_point": -1,
518 518  
519 - "dataLimit": "0 7999",
527 + "rid": "X",
520 520  
521 - "digitBinary": "十进制",
529 + "roleType": 1,
522 522  
523 - "addr": "9",
531 + "string_point": -1,
524 524  
525 - "rid": "D",
533 + "dataId": 105,
526 526  
527 - "roleType": 3,
535 + "addr_stat_no": -1,
528 528  
529 - "digitCount": "5,0",
537 + "updTime": 1745481123000,
530 530  
531 - "addrType": 2
539 + "dataLimit": "0 1",
532 532  
541 + "addr": "0",
542 +
543 + "digitCount": "",
544 +
545 + "boxId": 763,
546 +
547 + "addrType": 0
548 +
533 533   },
534 534  
535 - ……………
551 + {
536 536  
553 + "monitorId": 2276373,
554 +
555 + "monitorName": "y0",
556 +
557 + "digitBinary": "",
558 +
559 + "float_point": -1,
560 +
561 + "rid": "Y",
562 +
563 + "roleType": 3,
564 +
565 + "string_point": -1,
566 +
567 + "dataId": 105,
568 +
569 + "addr_stat_no": -1,
570 +
571 + "updTime": 1745480354000,
572 +
573 + "dataLimit": "0 1",
574 +
575 + "addr": "0",
576 +
577 + "digitCount": "",
578 +
579 + "boxId": 763,
580 +
581 + "addrType": 0
582 +
583 + },
584 +
537 537   {
538 538  
539 - "monitorId": 91541,
587 + "monitorId": 2276367,
540 540  
541 - "dataId": 105,
589 + "monitorName": "okg",
542 542  
543 - "monitorName": "Temp_5",
591 + "digitBinary": "",
544 544  
545 - "updTime": 1571965761000,
593 + "float_point": 1,
546 546  
547 - "dataLimit": "0 7999",
595 + "rid": "HDW",
548 548  
549 - "digitBinary": "十进制",
597 + "roleType": 3,
550 550  
551 - "addr": "5",
599 + "string_point": -1,
552 552  
553 - "rid": "D",
601 + "dataId": 105,
554 554  
555 - "roleType": 3,
603 + "addr_stat_no": -1,
556 556  
557 - "digitCount": "5,0",
605 + "updTime": 1745475213000,
558 558  
559 - "addrType": 2
607 + "dataLimit": "0 299999",
560 560  
609 + "addr": "10",
610 +
611 + "digitCount": "5,0",
612 +
613 + "boxId": 763,
614 +
615 + "addrType": 2
616 +
617 + },
618 +
619 + {
620 +
621 + "monitorId": 2276366,
622 +
623 + "monitorName": "hjdfh",
624 +
625 + "digitBinary": "",
626 +
627 + "float_point": -1,
628 +
629 + "rid": "HDX",
630 +
631 + "roleType": 3,
632 +
633 + "string_point": -1,
634 +
635 + "dataId": 105,
636 +
637 + "addr_stat_no": -1,
638 +
639 + "updTime": 1745475139000,
640 +
641 + "dataLimit": "0 299999,0 15",
642 +
643 + "addr": "0,0",
644 +
645 + "digitCount": "",
646 +
647 + "boxId": 763,
648 +
649 + "addrType": 0
650 +
561 561   }
562 562  
563 563   ],
564 564  
565 - "totalPage": 3,
655 + "totalPage": 1,
566 566  
567 - "totalRecord": 15,
657 + "totalRecord": 4,
568 568  
569 - "currentPage": 2
659 + "currentPage": 1
570 570  
571 571   }
572 572  
... ... @@ -573,20 +573,25 @@
573 573  }
574 574  
575 575  (% style="text-align:center" %)
576 -[[image:V-BOX HTTP manual_html_e7271097b71941cc.png||height="644" width="800" class="img-thumbnail"]]
666 +[[image:1751263773173-191.png]]
577 577  
578 -== (% id="cke_bm_1151S" style="display:none" %)** {{id name="_Toc24963743"/}}**(%%)**3.4 Tags data list** ==
668 +== **Tags data list** ==
579 579  
580 -**3.4.1 {{id name="_Toc24963744"/}}Parameters**
670 +{{warning}}
671 +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
672 +{{/warning}}
581 581  
674 +**~ {{id name="_Toc24963744"/}}Parameters**
675 +
582 582  (% class="table-bordered" %)
583 583  |**acturl**|(% colspan="3" %)we-data/realdata
584 584  |**Functions**|(% colspan="3" %)Get the tags data in the specified group in V-BOX.
585 -|(% rowspan="5" %)**Parameters**|Parameter|(% colspan="2" %)Description
679 +|(% colspan="1" rowspan="6" %)**Parameters**|Parameter|(% colspan="2" %)Description
586 586  |boxId|(% colspan="2" %)VBoxID(“None” means custom tag grouping)
587 587  |groupId|(% colspan="2" %)Group ID (Required)
588 588  |pageSize|(% colspan="2" %)Number of each page, 10 by default
589 589  |pageIndex|(% colspan="2" %)Number of current page, start from 1
684 +|devType|(% colspan="2" %)Device type (0:Box, 1:HMI)
590 590  |(% rowspan="11" %)**Return value**|Field name|(% colspan="2" %)Description
591 591  |(% rowspan="7" %)List|(% colspan="2" %)Real-time data list
592 592  |com|Communication port ID
... ... @@ -599,7 +599,7 @@
599 599  |totalRecord|(% colspan="2" %)Total record
600 600  |currentPage|(% colspan="2" %)current page
601 601  
602 -**3.4.2 {{id name="_Toc24963745"/}}Operating procedures**
697 +**~ {{id name="_Toc24963745"/}}Operating procedures**
603 603  
604 604  **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]]
605 605  
... ... @@ -610,6 +610,8 @@
610 610  
611 611  "boxId":"973"
612 612  
708 +"devType":"0"
709 +
613 613  "groupId":"7325"
614 614  
615 615  "pageSize":"5"
... ... @@ -617,73 +617,149 @@
617 617  "pageIndex":"2"
618 618  
619 619  (% style="text-align:center" %)
620 -[[image:V-BOX HTTP manual_html_b860bab44ebbc128.png||height="272" width="700" class="img-thumbnail"]]
717 +[[image:1751264089450-269.png||height="221" width="607"]]
621 621  
622 622  **Step3:** Get sign
623 623  
624 -boxId=973&comid=2&compvtkey=589625dce895454dbff9782c299db156&groupId=7325&pageIndex=2&pageSize=5&sid=2d7bfd344aa64d8ebc9beea0e4dad8ad&ts=1573897380&key=f1cd9351930d4e589922edbcf3b09a7c
721 +boxId=763&comid=128&compvtkey=7e421dd30a394d74b7b9c079e67e272c&devType=0&groupId=211608&pageIndex=1&pageSize=5&sid=0e583b1f48cf467bbf738365b3da1a26&ts=1751263921050&key=f1cd9351930d4e589922edbcf3b09a7c
625 625  
626 -MD5 sign: 0769228e66c945eed5431c41a96949f2
723 +MD5 sign: 19191b155e92f800f4db086bf06f8367
627 627  
628 -{"boxId":"973","groupId":"7325","pageSize":"5","pageIndex":"2","sid":"2d7bfd344aa64d8ebc9beea0e4dad8ad","comid":"2","compvtkey":"589625dce895454dbff9782c299db156","ts":"1573897380","sign":"0769228e66c945eed5431c41a96949f2"}
725 +{"compvtkey":"7e421dd30a394d74b7b9c079e67e272c","sign":"19191b155e92f800f4db086bf06f8367","comid":"128","sid":"0e583b1f48cf467bbf738365b3da1a26","ts":1751263921050}
629 629  
630 -**3.4.3 {{id name="_Toc24963746"/}}Result**
727 +**~ {{id name="_Toc24963746"/}}Result**
631 631  
632 632  {
633 633  
634 - "code": 200,
731 + "code": 200,
635 635  
636 - "msg": "ok",
733 + "msg": "ok",
637 637  
638 - "reqId": "1573905679365",
735 + "reqId": "1751264055206",
639 639  
640 - "result": {
737 + "result": {
641 641  
642 - "totalPage": 3,
739 + "totalPage": 1,
643 643  
644 - "list": [
741 + "list": [
645 645  
646 646   {
647 647  
648 - "com": 2939,
745 + "com": 0,
649 649  
650 - "monitorId": 91545,
747 + "string_point": -1,
651 651  
652 - "monitorName": "Temp_9",
749 + "monitorId": 2276374,
653 653  
654 - "groupId": 0,
751 + "addr_stat_no": -1,
655 655  
656 - "state": "1",
753 + "actAuth": 1,
657 657  
658 - "value": "90"
755 + "monitorName": "x0",
659 659  
757 + "groupId": 211608,
758 +
759 + "state": 0,
760 +
761 + "float_point": -1,
762 +
763 + "templateId": 0,
764 +
765 + "value": "0",
766 +
767 + "boxId": 763
768 +
660 660   },
661 661  
662 - …………
771 + {
663 663  
773 + "com": 0,
774 +
775 + "string_point": -1,
776 +
777 + "monitorId": 2276373,
778 +
779 + "addr_stat_no": -1,
780 +
781 + "actAuth": 3,
782 +
783 + "monitorName": "y0",
784 +
785 + "groupId": 211608,
786 +
787 + "state": 0,
788 +
789 + "float_point": -1,
790 +
791 + "templateId": 0,
792 +
793 + "value": "0",
794 +
795 + "boxId": 763
796 +
664 664   },
665 665  
666 666   {
667 667  
668 - "com": 2939,
801 + "com": 0,
669 669  
670 - "monitorId": 91541,
803 + "string_point": -1,
671 671  
672 - "monitorName": "Temp_5",
805 + "monitorId": 2276367,
673 673  
674 - "groupId": 0,
807 + "addr_stat_no": -1,
675 675  
676 - "state": "1",
809 + "actAuth": 3,
677 677  
678 - "value": "87"
811 + "monitorName": "okg",
679 679  
813 + "groupId": 211608,
814 +
815 + "state": 0,
816 +
817 + "float_point": 1,
818 +
819 + "templateId": 0,
820 +
821 + "value": "0",
822 +
823 + "boxId": 763
824 +
825 + },
826 +
827 + {
828 +
829 + "com": 0,
830 +
831 + "string_point": -1,
832 +
833 + "monitorId": 2276366,
834 +
835 + "addr_stat_no": -1,
836 +
837 + "actAuth": 3,
838 +
839 + "monitorName": "hjdfh",
840 +
841 + "groupId": 211608,
842 +
843 + "state": 0,
844 +
845 + "float_point": -1,
846 +
847 + "templateId": 0,
848 +
849 + "value": "0",
850 +
851 + "boxId": 763
852 +
680 680   }
681 681  
682 682   ],
683 683  
684 - "totalRecord": 15,
857 + "totalRecord": 4,
685 685  
686 - "currentPage": 2
859 + "currentPage": 1
687 687  
688 688   }
689 689  
... ... @@ -690,23 +690,25 @@
690 690  }
691 691  
692 692  (% style="text-align:center" %)
693 -[[image:V-BOX HTTP manual_html_705682e81eae5ea7.png||height="651" width="800" class="img-thumbnail"]]
866 +[[image:1751264191566-865.png]]
694 694  
695 -== **3.5 Modify tag data** ==
868 +== **Modify tag data** ==
696 696  
697 697  (((
698 -**3.5.1 Parameters**
871 +**Parameters**
699 699  )))
700 700  
701 701  (% class="table-bordered" %)
702 702  |**acturl**|(% colspan="2" %)we-data/updrealdata
703 703  |**Functions**|(% colspan="2" %)Modify tag data
704 -|(% rowspan="3" %)**Parameters**|Parameter|Description
877 +|(% rowspan="5" %)**Parameters**|Parameter|Description
878 +|boxId|Box ID
705 705  |monitorId|Tag ID
706 706  |value|value
881 +|devType|Device type (0:Box, 1:HMI)
707 707  |**Return value**|(% colspan="2" %)None
708 708  
709 -**3.5.2 Operating procedures**
884 +**Operating procedures**
710 710  
711 711  **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]]
712 712  
... ... @@ -715,27 +715,28 @@
715 715  
716 716  **Step2:** Set parameters on Params
717 717  
718 -"monitorId":"91541"
893 +boxId:6397578
894 +monitorId:1001
895 +value:66
896 +devType:1
719 719  
720 -"value":"60"
721 -
722 722  (% style="text-align:center" %)
723 -[[image:V-BOX HTTP manual_html_5a3153add75ca7b4.png||height="246" width="800" class="img-thumbnail"]]
899 +[[image:1746502882467-849.png]]
724 724  
725 725  **Step3:** Get sign
726 726  
727 -comid=2&compvtkey=589625dce895454dbff9782c299db156&monitorId=91541&sid=2d7bfd344aa64d8ebc9beea0e4dad8ad&ts=1573897380&value=60&key=f1cd9351930d4e589922edbcf3b09a7c
903 +boxId=6397578&comid=128&compvtkey=7e421dd30a394d74b7b9c079e67e272c&devType=1&monitorId=1001&sid=d8c98edd64da40289fef565c94924fe5&ts=171746501715435&value=66&key=f1cd9351930d4e589922edbcf3b09a7c
728 728  
729 -MD5 sign: 4119b1abc9176a187f781bece04a5296
905 +MD5 sign: 4802a362fde2ca5053ad79fe4d272200
730 730  
731 731  **Step4: **Set common of header
732 732  
733 -{"monitorId":"91541","value":"60","sid":"2d7bfd344aa64d8ebc9beea0e4dad8ad","comid":"2","compvtkey":"589625dce895454dbff9782c299db156","ts":"1573897380","sign":"4119b1abc9176a187f781bece04a5296"}
909 +{"compvtkey":"7e421dd30a394d74b7b9c079e67e272c","sign":"4802a362fde2ca5053ad79fe4d272200","comid":"128","sid":"d8c98edd64da40289fef565c94924fe5","ts":171746501715435}
734 734  
735 735  (% style="text-align:center" %)
736 -[[image:V-BOX HTTP manual_html_59d54a5d886ef614.png||height="244" width="700" class="img-thumbnail"]]
912 +[[image:1746503047845-902.png]]
737 737  
738 -**3.5.3 Result**
914 +**Result**
739 739  
740 740  {
741 741  
... ... @@ -750,23 +750,24 @@
750 750  }
751 751  
752 752  (% style="text-align:center" %)
753 -[[image:V-BOX HTTP manual_html_590c8dab9e80fd0f.png||height="425" width="700" class="img-thumbnail"]]
929 +[[image:1746503002289-932.png]]
754 754  
755 -== **3.6 {{id name="_Toc24963751"/}}Historical tags name list** ==
931 +== **Historical tags name list** ==
756 756  
757 -**3.6.1 Parameters**
933 +**Parameters**
758 758  
759 759  (% class="table-bordered" %)
760 760  |**acturl**|(% colspan="3" %)we-data/monitors
761 761  |**Functions**|(% colspan="3" %)Get a list of historical tags
762 -|(% rowspan="2" %)**Parameters**|Parameter|(% colspan="2" %)Description
763 -|boxId|(% colspan="2" %)VBoxID (Not required)
938 +|(% rowspan="3" %)**Parameters**|Parameter|(% colspan="2" %)Description
939 +|boxId|(% colspan="2" %)Box ID (Not required)
940 +|devType|(% colspan="2" %)Device type (0:Box, 1:HMI)
764 764  |(% rowspan="4" %)**Return value**|Field name|(% colspan="2" %)Description
765 765  |(% rowspan="3" %)list|(% colspan="2" %)Tag list
766 766  |monitorId|tag ID
767 767  |monitorName|tag name
768 768  
769 -**3.6.2 Operating procedures**
946 +**Operating procedures**
770 770  
771 771  **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]]
772 772  
... ... @@ -793,7 +793,7 @@
793 793  (% style="text-align:center" %)
794 794  [[image:V-BOX HTTP manual_html_dba52ac718eeb66e.png||height="228" width="700" class="img-thumbnail"]]
795 795  
796 -**3.6.3 Result**
973 +**Result**
797 797  
798 798  {
799 799  
... ... @@ -836,9 +836,9 @@
836 836  (% style="text-align:center" %)
837 837  [[image:V-BOX HTTP manual_html_2a739377a9fb10b2.png||height="400" width="700" class="img-thumbnail"]]
838 838  
839 -== (% id="cke_bm_1218S" style="display:none" %)** **(%%)**3.7 {{id name="_Toc24963755"/}}Historical tag data list** ==
1016 +== **Historical tag data list** ==
840 840  
841 -**​​​​​​​3.7.1 {{id name="_Toc24963756"/}}Parameters**
1018 +**~ {{id name="_Toc24963756"/}}Parameters**
842 842  
843 843  (% class="table-bordered" %)
844 844  |**acturl**|(% colspan="3" %)we-data/historydata
... ... @@ -858,7 +858,7 @@
858 858  |totalRecord|(% colspan="2" %)Total records
859 859  |currentPage|(% colspan="2" %)Current page
860 860  
861 -​​​​​​​**3.7.2 Operating procedures**
1038 +**Operating procedures**
862 862  
863 863  **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]]
864 864  
... ... @@ -893,7 +893,7 @@
893 893  (% style="text-align:center" %)
894 894  [[image:V-BOX HTTP manual_html_fac48b1179b555ee.png||height="291" width="700" class="img-thumbnail"]]
895 895  
896 -**3.7.3 Result**
1073 +**Result**
897 897  
898 898  {
899 899  
... ... @@ -956,14 +956,14 @@
956 956  (% style="text-align:center" %)
957 957  [[image:V-BOX HTTP manual_html_f3b62eb69687a214.png||height="476" width="700" class="img-thumbnail"]]
958 958  
959 -== **3.8 Alarm tags data list** ==
1136 +== **Alarm tags data list** ==
960 960  
961 -**​​​​​​​​​​​​​​3.8.1 {{id name="_Toc24963760"/}}Parameters**
1138 +**{{id name="_Toc24963760"/}}Parameters**
962 962  
963 963  (% class="table-bordered" %)
964 964  |**acturl**|(% colspan="3" %)we-data/alarmdata
965 965  |**Function**|(% colspan="3" %)Get alarm data
966 -|(% rowspan="9" %)**Parameters**|Parameter|(% colspan="2" %)Description
1143 +|(% rowspan="10" %)**Parameters**|Parameter|(% colspan="2" %)Description
967 967  |boxId|(% colspan="2" %)VBoxID, (Required)
968 968  |monitorBeginTime|(% colspan="2" %)Monitoring start time, (Not required)
969 969  |monitorEndTime|(% colspan="2" %)Monitoring end time, (Not required)
... ... @@ -980,6 +980,7 @@
980 980  
981 981  (Not necessary)
982 982  )))
1160 +|devType|(% colspan="2" %)Device type (0:Box, 1:HMI)
983 983  |(% rowspan="12" %)**Return value**|Field name|(% colspan="2" %)Description
984 984  |(% rowspan="8" %)List|(% colspan="2" %)Alarm data list
985 985  |monitorId|tag ID
... ... @@ -993,7 +993,7 @@
993 993  |totalRecord|(% colspan="2" %)Total records
994 994  |currentPage|(% colspan="2" %)Current page
995 995  
996 -**​​​​​​​​​​​​​​3.8.2 {{id name="_Toc24963761"/}}Operating procedures**
1174 +**~ {{id name="_Toc24963761"/}}Operating procedures**
997 997  
998 998  **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]]
999 999  
... ... @@ -1030,7 +1030,7 @@
1030 1030  (% style="text-align:center" %)
1031 1031  [[image:V-BOX HTTP manual_html_cd9ce84648b86cb9.png||height="269" width="700" class="img-thumbnail"]]
1032 1032  
1033 -**3.8.3 Result**
1211 +**Result**
1034 1034  
1035 1035  {
1036 1036  
... ... @@ -1109,9 +1109,9 @@
1109 1109  (% style="text-align:center" %)
1110 1110  [[image:V-BOX HTTP manual_html_d4a3e0114c402c27.png||height="475" width="700" class="img-thumbnail"]]
1111 1111  
1112 -== **3.9 Get device state** ==
1290 +== **Get device state** ==
1113 1113  
1114 -**3.9.1 {{id name="_Toc24963760"/}}Parameters**
1292 +**~ {{id name="_Toc24963760"/}}Parameters**
1115 1115  
1116 1116  (% class="table-bordered" %)
1117 1117  |**acturl**|(% colspan="3" %)we-data/getDeviceState
... ... @@ -1121,7 +1121,7 @@
1121 1121  |(% rowspan="2" %)**Return value**|Field name|(% colspan="2" %)Description
1122 1122  |state|(% colspan="2" %)vbox state: 1-online,  0-offline
1123 1123  
1124 -== **3.10 Send switch to device** ==
1302 +== **Send switch to device** ==
1125 1125  
1126 1126  **3.10.1 {{id name="_Toc24963760"/}}Parameters**
1127 1127  
... ... @@ -1132,9 +1132,9 @@
1132 1132  |(% style="width:450px" %)boxId|(% colspan="2" %)boxId(required)
1133 1133  |(% rowspan="1" style="width:102px" %)**Return value**|(% style="width:450px" %)Field name|(% colspan="2" %)Description
1134 1134  
1135 -= **4 Appendix** =
1313 += **Appendix** =
1136 1136  
1137 -== (% style="color:inherit; font-family:inherit; font-size:26px" %)**4.1 Data type**(%%) ==
1315 +== (% style="color:inherit; font-family:inherit; font-size:26px" %)**Data type**(%%) ==
1138 1138  
1139 1139  100: 16-bit binary
1140 1140  
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
1751263559328-234.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.DevinChen
Size
... ... @@ -1,0 +1,1 @@
1 +14.7 KB
Content
1751263596452-675.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.DevinChen
Size
... ... @@ -1,0 +1,1 @@
1 +22.9 KB
Content
1751263680622-643.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.DevinChen
Size
... ... @@ -1,0 +1,1 @@
1 +27.1 KB
Content
1751263773173-191.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.DevinChen
Size
... ... @@ -1,0 +1,1 @@
1 +28.5 KB
Content
1751264089450-269.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.DevinChen
Size
... ... @@ -1,0 +1,1 @@
1 +23.2 KB
Content
1751264191566-865.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.DevinChen
Size
... ... @@ -1,0 +1,1 @@
1 +26.1 KB
Content