Difference between revisions of "IoTGateway/RESTful APIv2 QuickGuide"
From ESS-WIKI
Chinchen.lin (talk | contribs) (→Linear Dust WSN Resources) |
Chinchen.lin (talk | contribs) |
||
| Line 57: | Line 57: | ||
|- | |- | ||
| 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 | ||
| + | |} | ||
| + | |||
| + | {| class="wikitable" | ||
| + | |- | ||
| + | ! 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 | ||
|} | |} | ||
Revision as of 08:44, 1 June 2016
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 |