Chapter 4: Json Control Interface; Controlling With Json - HomeSeer A2Z-Link User Manual

Home > JSON Control Interface
JSON Control Interface
Articles in this section
Controlling with
JSON
See also
Welcome
Getting Started
ASCII Control Interface
Home > JSON Control Interface > Controlling with JSON

Controlling with JSON

The A2Z‐Link can be controlled using JSON formatted data. This can be used to get status from devices as well as control devices.
The requests and posts are sent to the unit on port 80.
Some notes on this API:
* Parameters are not case sensitive
* most parameters accept "all" as an option to include all items, or if the parameter is not included "all" is assumed
The following commands are available:
GET requests
U R L
JSON Control Interface . 9
Description
Returns the status of a device in the system or all the devices in the
following format. The following parameters are supported in order to
filter the response:
location1=loc1 (only return the devices that are in the specific
location1, omit or set to "all" for all devices at this location)
location2=loc2 (only return the devices that are in the specific
location2, omit or set to "all" for all devices at this location)
ref=## (only return the device that matches the specific reference #,
this may be a list of reference #'s like 3467,2342,869, omit or set to
"all" to return all devices)
All GET requests are terminated with a CRLF.
If no JSON data is expected from the request, the return may be either
"ok", or "error".
This response is for 2 devices, the first is a thermostat temperature,
the second is a light switch:
{
"Name":"HomeSeer Devices",
A2Z­Link