Difference between revisions of "IoTGateway/RESTful APIv2 QuickGuide"

From ESS-WIKI
Jump to: navigation, search
(Created page with "= 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/<resourc...")
 
Line 14: Line 14:
  
 
MQTT response is not include ‘{"result": }’
 
MQTT response is not include ‘{"result": }’
 +
 +
== Linear Dust WSN Resources ==
 +
{| class="wikitable"
 +
|-
 +
! 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
 +
|}

Revision as of 09:39, 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