Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Authentication Result [application/vnd.hobson.authResult]

An authentication result is a response returned by an attempt to authenticate with the Hobson hub.

Field NameTypeDescription
tokenSTRINGThe bearer token to use for subsequent API calls.
userapplication/vnd.hobson.personThe user that was authenticated.

Device [application/vnd.hobson.device]

A device represents any smart device that Hobson knows how to monitor and control.

Field NameTypeDescription
availableBOOLEANIndicates whether the device is currently reachable.
cclassapplication/vnd.hobson.propertyContainerClassThe device's configuration class. This describes the supported configuration properties for the device.
configurationapplication/vnd.hobson.propertyContainerThe device's configuration property values.
lastCheckInNUMBERThe last time the device was heard from.
nameSTRINGThe device name.
preferredVariableapplication/vnd.hobson.variableThe device's preferred variable. For example, this is the variable that will be rendered to a dashboard tile.
telemetry

application/vnd.hobson.deviceTelemetry

The device's telemetry data.
typeSTRINGThe device type.
variablesapplication/vnd.hobson.itemListThe variables the device has published.

Hub [application/vnd.hobson.hub]

A hub represents the specific device that is running the Hobson Hub software.

Field NameTypeDescription
actionClassesapplication/vnd.hobson.itemListThe list of action classes that have been published to the hub.
cclassapplication/vnd.hobson.propertyContainerClassThe hub's configuration class. This describes the supported configuration properties for the hub.
conditionClassesapplication/vnd.hobson.itemListThe list of condition classes that have been published to the hub.
configurationapplication/vnd.hobson.propertyContainerThe hubs' configuration property values.
devicesapplication/vnd.hobson.itemListThe list of devices that have been published to the hub.
globalVariablesapplication/vnd.hobson.itemListThe list of global variables that have been published to the hub.
linksJSON ObjectA map of link relations to corresponding URI.
localPluginsapplication/vnd.hobson.itemListThe list of plugins that have been installed on the hub.
logapplication/vnd.hobson.itemListThe list of hub log entries.
nameSTRINGThe hub's configured name.
presenceEntitiesapplication/vnd.hobson.itemListThe list presence entities associated with the hub.
presenceLocationsapplication/vnd.hobson.itemListThe list of presence locations associated with the hub.
remotePluginsapplication/vnd.hobson.itemListThe list of plugins that are available from hub's configured remote repositories.
tasksapplication/vnd.hobson.itemListThe list of tasks that have been created on the hub.
versionSTRINGThe current hub version.

...