IoTGateway/RESTful APIv2 QuickGuide
From ESS-WIKI
Revision as of 08:44, 1 June 2016 by Chinchen.lin (talk | contribs)
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
| Header text | Header text |
|---|---|
| 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 |
| Header text | Header text |
|---|---|
| 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 |