Difference between revisions of "IoTGateway/RESTful APIv2 QuickGuide"
From ESS-WIKI
Chinchen.lin (talk | contribs) |
Chinchen.lin (talk | contribs) |
||
(3 intermediate revisions by the same user not shown) | |||
Line 5: | Line 5: | ||
RESTful API: <code><nowiki>http://<ip address>:port/restapi/<resource path> </nowiki></code> | RESTful API: <code><nowiki>http://<ip address>:port/restapi/<resource path> </nowiki></code> | ||
− | Default Port: 3000 | + | Default Port: <code>3000</code> |
− | Default User Name: admin | + | Default User Name: <code>admin</code> |
− | Default Password: admin | + | Default Password: <code>admin</code> |
− | MQTT Topic: <resource path> | + | MQTT Topic: <code><resource path></code> |
− | MQTT response is not include | + | MQTT response is not include <code>{"result": }</code> |
== Linear Dust WSN Resources == | == Linear Dust WSN Resources == | ||
Line 52: | Line 52: | ||
} | } | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Setting | + | | Example || curl -H "Content-Type: application/json" -X GET <nowiki>http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Setting</nowiki> |
|- | |- | ||
| Example || mosquito_sub -h <IP> -C 1 -t /WSNMgmt/IoTGW/WSN/<mac addr>/Setting | | Example || mosquito_sub -h <IP> -C 1 -t /WSNMgmt/IoTGW/WSN/<mac addr>/Setting | ||
|} | |} | ||
+ | |||
=== Set a new Network ID for the WSN manager. === | === Set a new Network ID for the WSN manager. === | ||
{| class="wikitable" | {| class="wikitable" | ||
Line 79: | Line 80: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X POST -d '{"sv":"1234"}' http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Setting/NetID | + | | Example || curl -H "Content-Type: application/json" -X POST -d '{"sv":"1234"}' <nowiki>http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Setting/NetID</nowiki> |
|- | |- | ||
Line 107: | Line 108: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X POST -d '{"sv":"DUSTNETWORKSROCK"}' http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Setting/JoinKey | + | | Example || curl -H "Content-Type: application/json" -X POST -d '{"sv":"DUSTNETWORKSROCK"}' <nowiki>http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Setting/JoinKey</nowiki> |
|- | |- | ||
| Example || mosquitto_pub -h <IP> -m '{"sv":"DUSTNETWORKSROCK"}' -t /WSNMgmt/IoTGW/WSN/<mac addr>/Setting/JoinKey | | Example || mosquitto_pub -h <IP> -m '{"sv":"DUSTNETWORKSROCK"}' -t /WSNMgmt/IoTGW/WSN/<mac addr>/Setting/JoinKey | ||
Line 162: | Line 163: | ||
} | } | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Info | + | | Example || curl -H "Content-Type: application/json" -X GET <nowiki>http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Info</nowiki> |
|- | |- | ||
Line 190: | Line 191: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X POST -d '{"bv":1}' http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Info/reset | + | | Example || curl -H "Content-Type: application/json" -X POST -d '{"bv":1}' <nowiki>http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Info/reset</nowiki> |
|- | |- | ||
| Example || mosquitto_pub -h <IP> -m '{"bv":1}' -t /WSNMgmt/IoTGW/WSN/<mac addr>/Info/reset | | Example || mosquitto_pub -h <IP> -m '{"bv":1}' -t /WSNMgmt/IoTGW/WSN/<mac addr>/Info/reset | ||
Line 238: | Line 239: | ||
} | } | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/NetworkStatistics | + | | Example || curl -H "Content-Type: application/json" -X GET <nowiki>http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/NetworkStatistics</nowiki> |
|- | |- | ||
Line 280: | Line 281: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Info | + | | Example || curl -H "Content-Type: application/json" -X GET <nowiki>http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Info</nowiki> |
|- | |- | ||
Line 309: | Line 310: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X POST -d '{"sv":"Motion123"}' http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Info/Name | + | | Example || curl -H "Content-Type: application/json" -X POST -d '{"sv":"Motion123"}' <nowiki>http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Info/Name</nowiki> |
|- | |- | ||
Line 338: | Line 339: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X POST -d '{"bv":1}' http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Info/reset | + | | Example || curl -H "Content-Type: application/json" -X POST -d '{"bv":1}' <nowiki>http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Info/reset</nowiki> |
|- | |- | ||
Line 370: | Line 371: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Action | + | | Example || curl -H "Content-Type: application/json" -X GET <nowiki>http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Action</nowiki> |
|- | |- | ||
Line 398: | Line 399: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X POST -d '{"bv":0}' http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Action/AutoReport | + | | Example || curl -H "Content-Type: application/json" -X POST -d '{"bv":0}' <nowiki>http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Action/AutoReport</nowiki> |
|- | |- | ||
Line 439: | Line 440: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/SenData | + | | Example || curl -H "Content-Type: application/json" -X GET <nowiki>http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/SenData</nowiki> |
|- | |- | ||
Line 483: | Line 484: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Net | + | | Example || curl -H "Content-Type: application/json" -X GET <nowiki>http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Net</nowiki> |
|- | |- | ||
Line 521: | Line 522: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/APIInfoMgmt/APIInfo | + | | Example || curl -H "Content-Type: application/json" -X GET <nowiki>http://username:password@<IP:Port>/restapi/APIInfoMgmt/APIInfo</nowiki> |
|- | |- | ||
Line 620: | Line 621: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/APIInfoMgmt/APIS | + | | Example || curl -H "Content-Type: application/json" -X GET <nowiki>http://username:password@<IP:Port>/restapi/APIInfoMgmt/APIS</nowiki> |
|- | |- | ||
| Example || MQTT N/A | | Example || MQTT N/A | ||
Line 654: | Line 655: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/AccountMgmt/AccountInfo | + | | Example || curl -H "Content-Type: application/json" -X GET <nowiki>http://username:password@<IP:Port>/restapi/AccountMgmt/AccountInfo</nowiki> |
|- | |- | ||
Line 697: | Line 698: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X PUT -d '{"username":"admin","password":"admin123"}' http://username:password@<IP:Port>/restapi/AccountMgmt/AccountConfig | + | | Example || curl -H "Content-Type: application/json" -X PUT -d '{"username":"admin","password":"admin123"}' <nowiki>http://username:password@<IP:Port>/restapi/AccountMgmt/AccountConfig</nowiki> |
|- | |- | ||
Line 774: | Line 775: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/SystemMgmt/SystemInfo | + | | Example || curl -H "Content-Type: application/json" -X GET <nowiki>http://username:password@<IP:Port>/restapi/SystemMgmt/SystemInfo</nowiki> |
|- | |- | ||
Line 889: | Line 890: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/SystemMgmt/NetworkInfo | + | | Example || curl -H "Content-Type: application/json" -X GET <nowiki>http://username:password@<IP:Port>/restapi/SystemMgmt/NetworkInfo</nowiki> |
− | |||
|- | |- | ||
| Example || mosquito_sub -h <IP> -C 1 -t /SystemMgmt/<mac addr>/NetworkInfo | | Example || mosquito_sub -h <IP> -C 1 -t /SystemMgmt/<mac addr>/NetworkInfo | ||
Line 943: | Line 943: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X PUT -d '{"ipaddr":"172.22.12.38","netmask":"255.255.252.0"} "gateway":"172.22.12.1","method":"static","iface":"eth0"' http://username:password@<IP:Port>/restapi/SystemMgmt/NetworkConfig | + | | Example || curl -H "Content-Type: application/json" -X PUT -d '{"ipaddr":"172.22.12.38","netmask":"255.255.252.0"} "gateway":"172.22.12.1","method":"static","iface":"eth0"' <nowiki>http://username:password@<IP:Port>/restapi/SystemMgmt/NetworkConfig</nowiki> |
|- | |- | ||
Line 986: | Line 986: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X POST -d '{"action":"reboot","value":1}' http://username:password@<IP:Port>/restapi | + | | Example || curl -H "Content-Type: application/json" -X POST -d '{"action":"reboot","value":1}' <nowiki>http://username:password@<IP:Port>/restapi |
− | /SystemMgmt/Action | + | /SystemMgmt/Action</nowiki> |
|- | |- | ||
Line 1,161: | Line 1,161: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/ProcessMgmt/Service | + | | Example || curl -H "Content-Type: application/json" -X GET <nowiki>http://username:password@<IP:Port>/restapi/ProcessMgmt/Service</nowiki> |
|- | |- | ||
Line 1,209: | Line 1,209: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X PUT -d '{"name":"xinetd","order":20,"onboot":1}' http://username:password@<IP:Port>/restapi | + | | Example || curl -H "Content-Type: application/json" -X PUT -d '{"name":"xinetd","order":20,"onboot":1}' <nowiki>http://username:password@<IP:Port>/restapi/ProcessMgmt/ServiceConfig</nowiki> |
− | /ProcessMgmt/ServiceConfig | ||
|- | |- | ||
Line 1,240: | Line 1,239: | ||
|- | |- | ||
− | | Example || curl -H "Content-Type: application/json" -X POST -d '{"name":"xinetd","action":"start"}' http://username:password@<IP:Port>/restapi | + | | Example || curl -H "Content-Type: application/json" -X POST -d '{"name":"xinetd","action":"start"}' <nowiki>http://username:password@<IP:Port>/restapi/ProcessMgmt/ServiceCtrl</nowiki> |
− | /ProcessMgmt/ServiceCtrl | ||
|- | |- |
Latest revision as of 02:49, 2 June 2016
Contents
- 1 RESTful API and MQTT Topics
- 1.1 URL Specification
- 1.2 Linear Dust WSN Resources
- 1.2.1 Retrieve the WSN manager setting information.
- 1.2.2 Set a new Network ID for the WSN manager.
- 1.2.3 Set a new Join Key for the WSN manager.
- 1.2.4 Retrieve the WSN manager information.
- 1.2.5 Reset the WSN manager.
- 1.2.6 Retrieve the WSN Network Statistics.
- 1.2.7 Retrieve the Sensor Hub information.
- 1.2.8 Set the Sensor Hub name.
- 1.2.9 Reset the Sensor Hub.
- 1.2.10 Retrieve the Sensor Hub available action.
- 1.2.11 Set the Sensor Hub to AutoReport.
- 1.2.12 Retrieve the Sensor Hub all sensor data.
- 1.2.13 Retrieve the Sensor Hub network information.
- 1.3 API Management Resources
- 1.4 Account Management Resources
- 1.5 System Management Resources
- 1.6 Process Management Resources
RESTful API and MQTT Topics
URL Specification
Every URL relates to a specific resource or list of resources.
RESTful API: http://<ip address>:port/restapi/<resource path>
Default Port: 3000
Default User Name: admin
Default Password: admin
MQTT Topic: <resource path>
MQTT response is not include {"result": }
Linear Dust WSN Resources
Retrieve the WSN manager setting information.
Description | Retrieve the WSN manager setting information. |
URI Resource Path | /WSNMgmt/IoTGW/WSN/<mac addr>/Setting |
MQTT Topic Format | /WSNMgmt/IoTGW/WSN/<mac addr>/Setting |
Method(HTTP/MQTT) | GET/SUB |
Request JSON Data | N/A |
Response JSON Data |
{ "result":{ "e":[ { "n":"NetID", "sv":"2001", "asm":"rw" }, { "n":"JoinKey", "sv":"JOINADVANTECHIOT", "asm":"rw" }, { "n":"Interface", "v":1, "asm":"r" } ] } } |
Example | curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Setting |
Example | mosquito_sub -h <IP> -C 1 -t /WSNMgmt/IoTGW/WSN/<mac addr>/Setting |
Set a new Network ID for the WSN manager.
Description | Set a new Network ID for the WSN manager. |
URI Resource Path | /WSNMgmt/IoTGW/WSN/<mac addr>/Setting/NetID |
MQTT Topic Format | /WSNMgmt/IoTGW/WSN/<mac addr>/Setting/NetID |
Method(HTTP/MQTT) | POST/PUB |
Request JSON Data |
{ "sv":"1234" } |
Response JSON Data |
{ "result":"true" } |
Example | curl -H "Content-Type: application/json" -X POST -d '{"sv":"1234"}' http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Setting/NetID |
Example | mosquitto_pub -h <IP> -m '{"sv":"1234"}' -t /WSNMgmt/IoTGW/WSN/<mac addr>/Setting/NetID |
Set a new Join Key for the WSN manager.
Description | Set a new Join Key for the WSN manager. |
URI Resource Path | /WSNMgmt/IoTGW/WSN/<mac addr>/Setting/JoinKey |
MQTT Topic Format | /WSNMgmt/IoTGW/WSN/<mac addr>/Setting/JoinKey |
Method(HTTP/MQTT) | POST/PUB |
Request JSON Data |
{ "sv":"DUSTNETWORKSROCK" } |
Response JSON Data |
{ "result":"true" } |
Example | curl -H "Content-Type: application/json" -X POST -d '{"sv":"DUSTNETWORKSROCK"}' http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Setting/JoinKey |
Example | mosquitto_pub -h <IP> -m '{"sv":"DUSTNETWORKSROCK"}' -t /WSNMgmt/IoTGW/WSN/<mac addr>/Setting/JoinKey |
Retrieve the WSN manager information.
Description | Retrieve the WSN manager information. |
URI Resource Path | /WSNMgmt/IoTGW/WSN/<mac addr>/Info |
MQTT Topic Format | /WSNMgmt/IoTGW/WSN/<mac addr>/Info |
Method(HTTP/MQTT) | GET/SUB |
Request JSON Data | N/A |
Response JSON Data |
{ "result":{ "e":[ { "n":"SenHubList", "sv":"00170d0000582cca,00170d0000306265", "asm":"r" }, { "n":"Neighbor", "sv":"00170d0000306265", "asm":"r" }, { "n":"Health", "v":100, "asm":"r" }, { "n":"Name", "sv":"WSN0", "asm":"r" }, { "n":"sw", "sv":"1.2.1.12", "asm":"r" }, { "n":"reset", "bv":0, "asm":"rw" } ] } } |
Example | curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Info |
Example | mosquito_sub -h <IP> -C 1 -t /WSNMgmt/IoTGW/WSN/<mac addr>/Info |
Reset the WSN manager.
Description | Reset the WSN manager. |
URI Resource Path | /WSNMgmt/IoTGW/WSN/<mac addr>/Info/reset |
MQTT Topic Format | /WSNMgmt/IoTGW/WSN/<mac addr>/Info/reset |
Method(HTTP/MQTT) | POST/PUB |
Request JSON Data |
{ "bv":1 } |
Response JSON Data |
{ "result":"true" } |
Example | curl -H "Content-Type: application/json" -X POST -d '{"bv":1}' http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/Info/reset |
Example | mosquitto_pub -h <IP> -m '{"bv":1}' -t /WSNMgmt/IoTGW/WSN/<mac addr>/Info/reset |
Retrieve the WSN Network Statistics.
Description | Retrieve the WSN Network Statistics. |
URI Resource Path | /WSNMgmt/IoTGW/WSN/<mac addr>/NetworkStatistics |
MQTT Topic Format | /WSNMgmt/IoTGW/WSN/<mac addr>/NetworkStatistics |
Method(HTTP/MQTT) | GET/SUB |
Request JSON Data | N/A |
Response JSON Data |
{ "result":{ "netstat":{ "NetReliability":100, "NetPathStability":97, "msNetLatency":400 }, "senhub":{ "e":[ { "mac":"00170d0000582cca", "id":1, "stat":"OPER", "routing":"YES", "reliablity":100, "mslatency":0 }, { "mac":"00170d0000306265", "id":2, "stat":"OPER", "routing":"YES", "reliablity":100, "mslatency":700 } ] } } } |
Example | curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/IoTGW/WSN/<mac addr>/NetworkStatistics |
Example | mosquito_sub -h <IP> -C 1 -t /WSNMgmt/IoTGW/WSN/<mac addr>/NetworkStatistics |
Retrieve the Sensor Hub information.
Description | Retrieve the Sensor Hub information. |
URI Resource Path | /WSNMgmt/<mac addr>/SenHub/Info |
MQTT Topic Format | /WSNMgmt/<mac addr>/SenHub/Info |
Method(HTTP/MQTT) | GET/SUB |
Request JSON Data | N/A |
Response JSON Data |
{ "result":{ "e":[ { "n":"Name", "sv":"Motion", "asm":"rw" }, { "n":"sw", "sv":"1.0.00", "asm":"r" }, { "n":"reset", "bv":1, "asm":"rw" } ] } } |
Example | curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Info |
Example | mosquito_sub -h <IP> -C 1 -t /WSNMgmt/<mac addr>/SenHub/Info |
Set the Sensor Hub name.
Description | Set the Sensor Hub name. |
URI Resource Path | /WSNMgmt/<mac addr>/SenHub/Info/Name |
MQTT Topic Format | /WSNMgmt/<mac addr>/SenHub/Info/Name |
Method(HTTP/MQTT) | POST/PUB |
Request JSON Data |
{ "sv":"Motion123" } |
Response JSON Data |
{ "result":"true" } |
Example | curl -H "Content-Type: application/json" -X POST -d '{"sv":"Motion123"}' http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Info/Name |
Example | mosquitto_pub -h <IP> -m '{"sv":"Motion123"}' -t /WSNMgmt/<mac addr>/SenHub/Info/Name |
Reset the Sensor Hub.
Description | Reset the Sensor Hub. |
URI Resource Path | /WSNMgmt/<mac addr>/SenHub/Info/reset |
MQTT Topic Format | /WSNMgmt/<mac addr>/SenHub/Info/reset |
Method(HTTP/MQTT) | POST/PUB |
Request JSON Data |
{ "bv":1 } |
Response JSON Data |
{ "result":"true" } |
Example | curl -H "Content-Type: application/json" -X POST -d '{"bv":1}' http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Info/reset |
Example | mosquitto_pub -h <IP> -m '{"bv":1}' -t /WSNMgmt/<mac addr>/SenHub/Info/reset |
Retrieve the Sensor Hub available action.
Description | Retrieve the Sensor Hub available action. |
URI Resource Path | /WSNMgmt/<mac addr>/SenHub/Action |
MQTT Topic Format | /WSNMgmt/<mac addr>/SenHub/Action |
Method(HTTP/MQTT) | GET/SUB |
Request JSON Data | N/A |
Response JSON Data |
{ "result":{ "e":[ { "n":"AutoReport", "bv":1, "asm":"rw" } ] } } |
Example | curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Action |
Example | mosquito_sub -h <IP> -C 1 -t /WSNMgmt/<mac addr>/SenHub/Action |
Set the Sensor Hub to AutoReport.
Description | Set the Sensor Hub to AutoReport. |
URI Resource Path | /WSNMgmt/<mac addr>/SenHub/Action/AutoReport |
MQTT Topic Format | /WSNMgmt/<mac addr>/SenHub/Action/AutoReport |
Method(HTTP/MQTT) | POST/PUB |
Request JSON Data |
{ "bv":0 } |
Response JSON Data |
{ "result":"true" } |
Example | curl -H "Content-Type: application/json" -X POST -d '{"bv":0}' http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Action/AutoReport |
Example | mosquitto_pub -h <IP> -m '{"bv":0}' -t /WSNMgmt/<mac addr>/SenHub/Action/AutoReport |
Retrieve the Sensor Hub all sensor data.
Description | Retrieve the Sensor Hub all sensor data. |
URI Resource Path | /WSNMgmt/<mac addr>/SenHub/SenData |
MQTT Topic Format | /WSNMgmt/<mac addr>/SenHub/SenData |
Method(HTTP/MQTT) | GET/SUB |
Request JSON Data | N/A |
Response JSON Data |
{ "result":{ "e":[ { "n":"Ultrasonic", "u":"cm", "v":408.00, "min":15, "max":645, "asm":"r", "type":"d", "rt":"ucum.cm", "st":"ipso", "exten":"" } ] } } |
Example | curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/SenData |
Example | mosquito_sub -h <IP> -C 1 -t /WSNMgmt/<mac addr>/SenHub/SenData |
Retrieve the Sensor Hub network information.
Description | Retrieve the Sensor Hub network information. |
URI Resource Path | /WSNMgmt/<mac addr>/SenHub/Net |
MQTT Topic Format | /WSNMgmt/<mac addr>/SenHub/Net |
Method(HTTP/MQTT) | GET/SUB |
Request JSON Data | N/A |
Response JSON Data |
{ "result":{ "e":[ { "n":"Health", "v":100, "asm":"r" }, { "n":"Neighbor", "sv":"00170d0000582cca", "asm":"r" }, { "n":"sw", "sv":"1.0.00", "asm":"r" } ] } } |
Example | curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/WSNMgmt/<mac addr>/SenHub/Net |
Example | mosquito_sub -h <IP> -C 1 -t /WSNMgmt/<mac addr>/SenHub/Net |
API Management Resources
Retrieve all API resources, and API version.
Description | Retrieve all API resources, and API version. |
URI Resource Path | /APIInfoMgmt/APIInfo |
MQTT Topic Format | /APIInfoMgmt/<mac addr>/APIInfo |
Method(HTTP/MQTT) | GET/SUB |
Request JSON Data | N/A |
Response JSON Data |
{ "result":{ "Mgmt":{ "item":[ "APIInfoMgmt", "WSNMgmt", "AccountMgmt", "SystemMgmt", "ProcessMgmt" ] }, "totalsize":5, "version":"1.0.0" } } |
Example | curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/APIInfoMgmt/APIInfo |
Example | mosquito_sub -h <IP> -C 1 -t /APIInfoMgmt/<mac addr>/APIInfo |
Retrieve available APIs.
Description | Retrieve available APIs. |
URI Resource Path | /APIInfoMgmt/APIS |
MQTT Topic Format | N/A |
Method(HTTP) | GET |
Request JSON Data | N/A |
Response JSON Data |
{ "apis":[ { "uri":"/APIInfoMgmt/APIS" }, { "uri":"/APIInfoMgmt/APIInfo" }, { "uri":"/AccountMgmt/AccoutInfo" }, { "uri":"/AccountMgmt/AccoutConfig" }, { "uri":"/SystemMgmt/SystemInfo" }, { "uri":"/SystemMgmt/Action" }, { "uri":"/SystemMgmt/NetworkInfo" }, { "uri":"/SystemMgmt/NetworkConfig" }, { "uri":"/ProcessMgmt/Service" }, { "uri":"/ProcessMgmt/ServiceConfig" }, { "uri":"/ProcessMgmt/ServiceCtrl" }, { "uri":"/WSNMgmt/IoTGW/WSN/00170d0000582cca/Info" }, { "uri":"/WSNMgmt/IoTGW/WSN/00170d0000582cca/Info/reset" }, { "uri":"/WSNMgmt/IoTGW/WSN/00170d0000582cca/Setting" }, { "uri":"/WSNMgmt/IoTGW/WSN/00170d0000582cca/Setting/NetID" }, { "uri":"/WSNMgmt/IoTGW/WSN/00170d0000582cca/Setting/JoinKey" }, { "uri":"/WSNMgmt/IoTGW/WSN/00170d0000582cca/NetworkStatistics" }, { "uri":"/WSNMgmt/00170d0000306265/SenHub/Action" }, { "uri":"/WSNMgmt/00170d0000306265/SenHub/Action/AutoReport" }, { "uri":"/WSNMgmt/00170d0000306265/SenHub/Info" }, { "uri":"/WSNMgmt/00170d0000306265/SenHub/Info/Name" }, { "uri":"/WSNMgmt/00170d0000306265/SenHub/Info/reset" }, { "uri":"/WSNMgmt/00170d0000306265/SenHub/Net" }, { "uri":"/WSNMgmt/00170d0000306265/SenHub/SenData" } ], "totalsize":24 } |
Example | curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/APIInfoMgmt/APIS |
Example | MQTT N/A |
Account Management Resources
Retrieve all accounts information.
Description | Retrieve all accounts information. |
URI Resource Path | /AccountMgmt/AccountInfo |
MQTT Topic Format | /AccountMgmt/<mac addr>/AccountInfo |
Method(HTTP/MQTT) | GET/SUB |
Request JSON Data | N/A |
Response JSON Data |
{ "result":{ "item":[ { "username":"admin", "password":"$2a$10$2EXoFOQ6xsFZTguDwVWPaO63b17216uesj9TO6Phu/6Ci85DKqAte", "lastchange":"1463535734" } ], "totalsize":1 } } |
Example | curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/AccountMgmt/AccountInfo |
Example | mosquito_sub -h <IP> -C 1 -t /AccountMgmt/<mac addr>/AccountInfo |
Item | Description |
---|---|
totalsize | Number of items in the result. |
username | Account name. |
password | Account password, but will not show real password. |
lastchange | Account last change time. |
Change account password.
Description | Change account password. |
URI Resource Path | /AccountMgmt /AccountConfig |
MQTT Topic Format | N/A |
Method(HTTP) | PUT |
Request JSON Data |
{ "username":"admin", "password":"admin123" } |
Response JSON Data |
{ "result":"true" } |
Example | curl -H "Content-Type: application/json" -X PUT -d '{"username":"admin","password":"admin123"}' http://username:password@<IP:Port>/restapi/AccountMgmt/AccountConfig |
Example | MQTT N/A |
System Management Resources
Retrieve system information.
Description | Retrieve system information. |
URI Resource Path | /SystemMgmt/SystemInfo |
MQTT Topic Format | /SystemMgmt/<mac addr>/SystemInfo |
Method(HTTP/MQTT) | GET/SUB |
Request JSON Data | N/A |
Response JSON Data |
{ "result":{ "SystemInfo":{ "arch":"arm", "platform":"linux", "os":"Linux 3.10.17-1.0.2_ga", "systemtime":"2016-06-01 02:39:28", "uptime":"0 days,0 hours,30 minutes,30 seconds", "cpu":{ "cpuinfo":[ { "model":"ARMv7 Processor rev 10 (v7l)", "speed":996 }, { "model":"ARMv7 Processor rev 10 (v7l)", "speed":996 } ], "totalsize":2 }, "cpuusage":{ "avgload":0.24, "currentload":6.9 }, "mem":{ "memsize":"1001.78 MB", "memusage":35.53 }, "swap":{ "swapsize":"0", "swapusage":0 }, "disk":{ "part":[ { "name":"/dev/root", "mount":"/", "size":"2.08 GB", "usage":86.7 }, { "name":"/dev/mmcblk1p1", "mount":"/media/mmcblk1p1", "size":"7.98 MB", "usage":62.78 } ], "totalsize":2 } } } } |
Example | curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/SystemMgmt/SystemInfo |
Example | mosquito_sub -h <IP> -C 1 -t /SystemMgmt/<mac addr>/SystemInfo |
Item | Description |
---|---|
arch | Device architecture. |
platform | Device OS Platform. |
os | Device OS version. |
systemtime | Device System time. |
uptime | Device uptime. |
cpu | Device CPU information. |
cpuusage | Device CPU usage. |
memsize | Device memory size. |
memusage | Device memory usage. |
swapsize | Device swap size. |
swapusage | Device swap usage. |
disk.part | Device disk partitions. |
disk.part.name | Device disk name. |
disk.part.mount | Device disk mount point. |
disk.part.size | Device disk size. |
disk.part.usage | Device disk usage. |
Retrieve network information.
Description | Retrieve network information. |
URI Resource Path | /SystemMgmt/NetworkInfo |
MQTT Topic Format | /SystemMgmt/<mac addr>/NetworkInfo |
Method(HTTP/MQTT) | GET/SUB |
Request JSON Data | N/A |
Response JSON Data |
{ "result":{ "NetworkInfo":{ "hostname":"imx6qwise3310", "gateway":"172.22.15.254", "dns":{ "nameservers":[ { "nameserver":"172.22.2.100" }, { "nameserver":"172.20.1.99" } ] }, "iface":{ "lo":[ { "address":"127.0.0.1", "netmask":"255.0.0.0", "family":"IPv4", "mac":"00:00:00:00:00:00" }, { "address":"::1", "netmask":"ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff", "family":"IPv6", "mac":"00:00:00:00:00:00" } ], "eth0":[ { "address":"172.22.12.20", "netmask":"255.255.252.0", "family":"IPv4", "mac":"00:04:9f:01:11:11" }, { "address":"fe80::204:9fff:fe01:1111", "netmask":"ffff:ffff:ffff:ffff::", "family":"IPv6", "mac":"00:04:9f:01:11:11" } ], "eth0:0":[ { "address":"192.168.0.1", "netmask":"255.255.255.0", "family":"IPv4", "mac":"00:00:00:00:00:00" } ] } } } } |
Example | curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/SystemMgmt/NetworkInfo |
Example | mosquito_sub -h <IP> -C 1 -t /SystemMgmt/<mac addr>/NetworkInfo |
Item | Description |
---|---|
hostname | Device Hostname. |
gateway | Device Default Gateway. |
dns | Name server setting. |
iface | Device Network Interface name. |
address | Device IP address. |
netmask | Device Netmask. |
family | IPv4 or IPV6. |
mac | Device MAC address. |
Edit network settings.
Description | Edit network settings. |
URI Resource Path | /SystemMgmt/NetworkConfig |
MQTT Topic Format | N/A |
Method(HTTP) | PUT |
Request JSON Data |
{ "ipaddr":"172.22.12.38", "netmask":"255.255.252.0", "gateway":"172.22.12.1", "method":"static", "iface":"eth0" } |
Response JSON Data |
{ "result":"true" } |
Example | curl -H "Content-Type: application/json" -X PUT -d '{"ipaddr":"172.22.12.38","netmask":"255.255.252.0"} "gateway":"172.22.12.1","method":"static","iface":"eth0"' http://username:password@<IP:Port>/restapi/SystemMgmt/NetworkConfig |
Example | MQTT N/A |
Item | Description |
---|---|
iface | Device Network Interface name. |
ipaddr | Device IP address. |
netmask | Device Netmask. |
gateway | Device Default Gateway. |
method | DHCP or Static IP. |
Set device "reboot" by action.
Description | Set device "reboot" by action. |
URI Resource Path | /SystemMgmt/Action |
MQTT Topic Format | N/A |
Method(HTTP) | POST |
Request JSON Data |
{ "action":"reboot", "value":1 } |
Response JSON Data |
{ "result":"true" } |
Example | curl -H "Content-Type: application/json" -X POST -d '{"action":"reboot","value":1}' http://username:password@<IP:Port>/restapi /SystemMgmt/Action |
Example | MQTT N/A |
Item | Description |
---|---|
action | Determine action command. |
value | Determine action parameter. |
Process Management Resources
Retrieve all services information.
Description | Retrieve all services information. |
URI Resource Path | /ProcessMgmt/Service |
MQTT Topic Format | /ProcessMgmt/<mac addr>/Service |
Method(HTTP/MQTT) | GET/SUB |
Request JSON Data | N/A |
Response JSON Data |
{ "result":{ "totalsize":27, "service":[ { "name":"alljoyn", "onboot":0, "order":0 }, { "name":"apmd", "onboot":1, "order":"20" }, { "name":"avahi-daemon", "onboot":1, "order":"21" }, { "name":"connman", "onboot":1, "order":"05" }, { "name":"crond", "onboot":1, "order":"90" }, { "name":"dbus-1", "onboot":1, "order":"02" }, { "name":"dustlink", "onboot":0, "order":0 }, { "name":"hwclock.sh", "onboot":1, "order":"20" }, { "name":"mqtt", "onboot":1, "order":"96" }, { "name":"neard", "onboot":1, "order":"64" }, { "name":"nfsserver", "onboot":1, "order":"20" }, { "name":"ntpd", "onboot":1, "order":"20" }, { "name":"ofono", "onboot":1, "order":"22" }, { "name":"oprofileui-server", "onboot":1, "order":"99" }, { "name":"ppp", "onboot":0, "order":0 }, { "name":"rc.local", "onboot":1, "order":"99" }, { "name":"rmnologin.sh", "onboot":1, "order":"99" }, { "name":"rpcbind", "onboot":0, "order":0 }, { "name":"saagent", "onboot":1, "order":"99" }, { "name":"sawatchdog", "onboot":1, "order":"99" }, { "name":"serialmux", "onboot":0, "order":0 }, { "name":"sshd", "onboot":1, "order":"09" }, { "name":"stop-bootlogd", "onboot":1, "order":"99" }, { "name":"syslog", "onboot":1, "order":"20" }, { "name":"tcf-agent", "onboot":1, "order":"99" }, { "name":"webmin", "onboot":1, "order":"99" }, { "name":"xinetd", "onboot":1, "order":"20" } ] } } |
Example | curl -H "Content-Type: application/json" -X GET http://username:password@<IP:Port>/restapi/ProcessMgmt/Service |
Example | mosquito_sub -h <IP> -C 1 -t /ProcessMgmt/<mac addr>/Service |
Item | Description |
---|---|
totalsize | Number of services in the result. |
name | Service name. |
order | Service startup order. |
onboot | Service on boot or not. |
Edit service settings.
Description | Edit service settings. |
URI Resource Path | /ProcessMgmt/ServiceConfig |
MQTT Topic Format | N/A |
Method(HTTP) | PUT |
Request JSON Data |
{ "name":"xinetd", "order":20, "onboot":1 } |
Response JSON Data |
{ "result":{ "name":"xinetd", "onboot":1, "order":20 } } |
Example | curl -H "Content-Type: application/json" -X PUT -d '{"name":"xinetd","order":20,"onboot":1}' http://username:password@<IP:Port>/restapi/ProcessMgmt/ServiceConfig |
Example | MQTT N/A |
Start and Stop service.
Description | Start and Stop service. |
URI Resource Path | /ProcessMgmt/ServiceCtrl |
MQTT Topic Format | N/A |
Method(HTTP) | POST |
Request JSON Data |
{ "name":"xinetd", "action":"start" } |
Response JSON Data |
{ "result":"true" } |
Example | curl -H "Content-Type: application/json" -X POST -d '{"name":"xinetd","action":"start"}' http://username:password@<IP:Port>/restapi/ProcessMgmt/ServiceCtrl |
Example | MQTT N/A |
Item | Description |
---|---|
name | Service name. |
action | Start or Stop service. |