Download OpenAPI specification:Download
It is specific API of BleBox devices with API type: gateBox
Please check API type and API level (version) before use,
if you don't see the expected field in response from a real device then hardware version do not support this feature.
{- "device": {
- "deviceName": "My BleBox device name",
- "product": "shutterBoxV2",
- "type": "shutterBox",
- "apiLevel": "20210413",
- "hv": "9.1d",
- "fv": "0.987",
- "id": "g650e32d2217",
- "ip": "192.168.1.11"
}
}
Returns general information about device
It is deprecated -> look at:
{- "device": {
- "deviceName": "My BleBox device name",
- "product": "shutterBoxV2",
- "type": "shutterBox",
- "apiLevel": "20210413",
- "hv": "9.1d",
- "fv": "0.987",
- "id": "g650e32d2217",
- "ip": "192.168.1.11"
}
}
Returns information about internal WiFi AP or about connected local WiFi network
{- "ssid": "WiFi_Name",
- "bssid": "70:4f:25:24:11:ae",
- "ip": "192.168.1.11",
- "mac": "bb:50:ec:2d:22:17",
- "station_status": 5,
- "tunnel_status": 5,
- "apEnable": true,
- "apSSID": "shutterBox-g650e32d2217",
- "apPasswd": "my_secret_password",
- "channel": 7
}
Allows to set interal access Point's ssid and password. Allows also to turn off internal AP.
required | object Internal access Point's settings |
{- "network": {
- "apEnable": true,
- "apSSID": "shutterBox-g650e32d2217",
- "apPasswd": "my_secret_password"
}
}
{- "device": {
- "deviceName": "My BleBox device name",
- "product": "shutterBoxV2",
- "type": "shutterBox",
- "apiLevel": "20210413",
- "hv": "9.1d",
- "fv": "0.987",
- "id": "g650e32d2217",
- "ip": "192.168.1.11"
}, - "network": {
- "ssid": "WiFi_Name",
- "bssid": "70:4f:25:24:11:ae",
- "ip": "192.168.1.11",
- "mac": "bb:50:ec:2d:22:17",
- "station_status": 5,
- "tunnel_status": 5,
- "apEnable": true,
- "apSSID": "shutterBox-g650e32d2217",
- "apPasswd": "my_secret_password",
- "channel": 7
}
}
Perform WiFi scan and return list of found WiFi networks. Return conflict if scanning is in progress
{- "ap": [
- {
- "ssid": "Funny_WiFi_Name",
- "rssi": -60,
- "enc": 3
}, - {
- "ssid": "Less_Funny_WiFi_Name",
- "rssi": -75,
- "enc": 4
}, - {
- "ssid": "Not_Funny_WiFi_Name",
- "rssi": -90,
- "enc": 0
}
]
}
Perform connect to local WiFi network
ssid required | string (ssid_connect) [ 0 .. 32 ] characters SSID of WiFi network. |
pwd | string or null (pwd) [ 0 .. 64 ] characters Password to WiFi network. Empty string or 'null' indicates open mode (without password). |
{- "ssid": "WiFi_Name",
- "pwd": "my_secret_password"
}
{- "ssid": "WiFi_Name",
- "station_status": 5
}
Returns extended information about device and gate
(all parameters needed to display user interface)
{- "gate": {
- "currentPos": 50,
- "openCloseMode": 0,
- "gateType": 1,
- "gatePulseTimeMs": 1500,
- "gateOutputState": 0,
- "extraButtonType": 1,
- "extraButtonPulseTimeMs": 1500,
- "extraButtonOutputState": 0,
- "inputsType": 0
}
}
extended information about device and gate
(all parameters needed to display user interface)
It is deprecated -> look at:
{- "gate": {
- "currentPos": 50,
- "openCloseMode": 0,
- "gateType": 1,
- "gatePulseTimeMs": 1500,
- "gateOutputState": 0,
- "extraButtonType": 1,
- "extraButtonPulseTimeMs": 1500,
- "extraButtonOutputState": 0,
- "inputsType": 0
}
}
Send API command to the device as URL path: gate short command.
shortCommand required | string (shortCommand) Enum: "p" "s" "o" "c" "n" Example: p
Primary and secondary actions simply trigger gate and extraButton output and return a 200 response. Open, close, next are abstract commands to provide a common control interface for different types of device connections. These commands are translated internaly to p / s / no action / return error according to the selected openCloseMode. If the command can be executed in the given gate state, the request returns a 200 response. If the command cannot be executed in the given gate state (e.g. unable to predict next step of the "step-by-step" gate controller option), a 409 error response will be returned. See openCloseMode for details. |
{- "gate": {
- "currentPos": 50,
- "gateOutputState": 0,
- "extraButtonOutputState": 0
}
}
Send API command to the device as URL path: gate short command.
shortCommand required | string (shortCommand) Enum: "p" "s" "o" "c" "n" Example: p
Primary and secondary actions simply trigger gate and extraButton output and return a 200 response. Open, close, next are abstract commands to provide a common control interface for different types of device connections. These commands are translated internaly to p / s / no action / return error according to the selected openCloseMode. If the command can be executed in the given gate state, the request returns a 200 response. If the command cannot be executed in the given gate state (e.g. unable to predict next step of the "step-by-step" gate controller option), a 409 error response will be returned. See openCloseMode for details. |
{- "gate": {
- "currentPos": 50,
- "gateOutputState": 0,
- "extraButtonOutputState": 0
}
}
{- "settings": {
- "deviceName": "My BleBox device name",
- "tunnel": {
- "enabled": 1,
- "logEnabled": 1
}, - "statusLed": {
- "enabled": 1
}, - "gate": {
- "openCloseMode": 0,
- "gateType": 1,
- "gatePulseTimeMs": 1500,
- "gateRelayNumber": 0,
- "gateInvert": 0,
- "extraButtonType": 1,
- "extraButtonPulseTimeMs": 1500,
- "extraButtonInvert": 0,
- "extraButtonRelayNumber": 1,
- "inputsType": 0,
- "openLimitSwitchInputNumber": 0,
- "closeLimitSwitchInputNumber": 1,
- "openLimitSwitchInputInvert": 0,
- "closeLimitSwitchInputInvert": 0,
- "fieldsPreferences": [
- {
- "name": "openCloseMode",
- "values": [
- 0,
- 1
]
}, - {
- "name": "gateType",
- "disabled": 1
}, - {
- "name": "gatePulseTimeMs",
- "minValue": 100,
- "maxValue": 300000
}, - {
- "name": "extraButtonPulseTimeMs",
- "minValue": 100,
- "maxValue": 300000
}, - {
- "name": "inputsType",
- "values": [
- 0,
- 1
]
}
]
}
}
}
Allow to set device's specific settings
object Object which contain specific settings |
{- "settings": {
- "deviceName": "My BleBox device name",
- "tunnel": {
- "enabled": 1,
- "logEnabled": 1
}, - "statusLed": {
- "enabled": 1
}, - "gate": {
- "openCloseMode": 0,
- "gateType": 1,
- "gatePulseTimeMs": 1500,
- "gateRelayNumber": 0,
- "gateInvert": 0,
- "extraButtonType": 1,
- "extraButtonPulseTimeMs": 1500,
- "extraButtonInvert": 0,
- "extraButtonRelayNumber": 1,
- "inputsType": 0,
- "openLimitSwitchInputNumber": 0,
- "closeLimitSwitchInputNumber": 1,
- "openLimitSwitchInputInvert": 0,
- "closeLimitSwitchInputInvert": 0
}
}
}
{- "settings": {
- "deviceName": "My BleBox device name",
- "tunnel": {
- "enabled": 1,
- "logEnabled": 1
}, - "statusLed": {
- "enabled": 1
}, - "gate": {
- "openCloseMode": 0,
- "gateType": 1,
- "gatePulseTimeMs": 1500,
- "gateRelayNumber": 0,
- "gateInvert": 0,
- "extraButtonType": 1,
- "extraButtonPulseTimeMs": 1500,
- "extraButtonInvert": 0,
- "extraButtonRelayNumber": 1,
- "inputsType": 0,
- "openLimitSwitchInputNumber": 0,
- "closeLimitSwitchInputNumber": 1,
- "openLimitSwitchInputInvert": 0,
- "closeLimitSwitchInputInvert": 0,
- "fieldsPreferences": [
- {
- "name": "openCloseMode",
- "values": [
- 0,
- 1
]
}, - {
- "name": "gateType",
- "disabled": 1
}, - {
- "name": "gatePulseTimeMs",
- "minValue": 100,
- "maxValue": 300000
}, - {
- "name": "extraButtonPulseTimeMs",
- "minValue": 100,
- "maxValue": 300000
}, - {
- "name": "inputsType",
- "values": [
- 0,
- 1
]
}
]
}
}
}