(→Status API) |
|||
Line 22: | Line 22: | ||
''.json'' methods implement fully the same structure of data as ''.php'' version. | ''.json'' methods implement fully the same structure of data as ''.php'' version. | ||
''.msgpack'' methods have MeasagePack-encoded data in the same order as ''.json'' version. | ''.msgpack'' methods have MeasagePack-encoded data in the same order as ''.json'' version. | ||
− | Please check info about General Status API (''.php'') at [[API/Status]]. | + | Please check info about General Status API (''.php'') at [[API/Status|Status API]]. |
This API supports zlib compression requested by ''Accept-Encoding: deflate''. | This API supports zlib compression requested by ''Accept-Encoding: deflate''. | ||
Since version BrandMeister 20190421-185653 has built-in web server.
Embedded web server provides several services such as:
system.php provides a data of entry point of HTTP interface. Please check "remote" object, returned by system.php. Port parameter corresponds to TCP port and ‘'Secure'’ indicates using of HTTPS (or HTTP).
.json methods implement fully the same structure of data as .php version. .msgpack methods have MeasagePack-encoded data in the same order as .json version. Please check info about General Status API (.php) at Status API. This API supports zlib compression requested by Accept-Encoding: deflate.
This service API requires to use HTTP Digest Authentication, where username is an registered application ID. All requests should be sent as HTTP POST method having type application/x-www-form-urlencoded or application/form-data In case of success server returns HTTP code 200 or 500 in case of failure.
source - ID to be used as a source
destination - ID of destination station or group
type - private or announce (for group message)
data - attached file in plain format of AMBE mode 33
source - ID to be used as a source
destination - ID of destination station or group
type - private or announce (for group message)
text - message text in UTF-8
interval - long-poll timeout in milliseconds (optional)
Long-polling mode responds to get a status of message delivery (check section Long-polling):
source - ID to be used as a source
destination - ID of destination station or group
output1 ... output8 - command for each output (same as MQTT API): 0 = None, 20 = Clear, 21 = Set, 22 = Toggle, 23 = Pulse
source - ID to be used as a source
destination - ID of destination station or group
interval - long-poll timeout in milliseconds
source - ID to be used as a source
destination - ID of destination station or group
interval - long-poll timeout in milliseconds
source - ID to be used as a source
destination - ID of destination station or group
interval - long-poll timeout in milliseconds
In case of long-polling mode, the API will always answer with HTTP code 200, and then slowly transmit response:
Objects list is available via system.php and D-BUS API.
Health check compatible with Consul:
Detailed metric information in JSON format
Since version BrandMeister 20190421-185653 has built-in web server.
Embedded web server provides several services such as:
system.php provides a data of entry point of HTTP interface. Please check "remote" object, returned by system.php. Port parameter corresponds to TCP port and ‘'Secure'’ indicates using of HTTPS (or HTTP).
.json methods implement fully the same structure of data as .php version. .msgpack methods have MeasagePack-encoded data in the same order as .json version. Please check info about General Status API (.php) at API/Status. This API supports zlib compression requested by Accept-Encoding: deflate.
This service API requires to use HTTP Digest Authentication, where username is an registered application ID. All requests should be sent as HTTP POST method having type application/x-www-form-urlencoded or application/form-data In case of success server returns HTTP code 200 or 500 in case of failure.
source - ID to be used as a source
destination - ID of destination station or group
type - private or announce (for group message)
data - attached file in plain format of AMBE mode 33
source - ID to be used as a source
destination - ID of destination station or group
type - private or announce (for group message)
text - message text in UTF-8
interval - long-poll timeout in milliseconds (optional)
Long-polling mode responds to get a status of message delivery (check section Long-polling):
source - ID to be used as a source
destination - ID of destination station or group
output1 ... output8 - command for each output (same as MQTT API): 0 = None, 20 = Clear, 21 = Set, 22 = Toggle, 23 = Pulse
source - ID to be used as a source
destination - ID of destination station or group
interval - long-poll timeout in milliseconds
source - ID to be used as a source
destination - ID of destination station or group
interval - long-poll timeout in milliseconds
source - ID to be used as a source
destination - ID of destination station or group
interval - long-poll timeout in milliseconds
In case of long-polling mode, the API will always answer with HTTP code 200, and then slowly transmit response:
Objects list is available via system.php and D-BUS API.
Health check compatible with Consul:
Detailed metric information in JSON format