Skip to content

Cognitive Systems App Cloud API

The AppCloud APIs are used by mobile applications to communicate with the Cognitive Systems Infrastructure.

Download OpenAPI description
app_cloud.json
app_cloud.yaml
Languages
Servers
Mock server

https://docs.cognitivesystems.com/_mock/assets/specs/api/app_cloud/

https://docs.cognitivesystems.com/api/v1/

Overview

Operations

Out of Box

Operations

Logging In

Operations

Geofencing

Operations

Account Management

Operations

Network Settings

Operations

Sounding v2

Operations

Events, History, and Visualizations

Operations

Household Insights

Operations

Zone Priority

Operations

Universal Alerting

Operations

Meta

Operations

Sensor Integration

Operations

Delete Sensor Integration

Request

Deletes an integration, cascades the deletion to any added devices from the devices table, and purges the sensor detection history for the given network. Propagates an IntegrationDeletedEvent containing the userThingName. Deletes the account and hardware association in ThirdReality.

curl -i -X DELETE \
  https://docs.cognitivesystems.com/_mock/assets/specs/api/app_cloud/sensors/integrations

Responses

204 No Content

Initialize Hub Pairing Mode

Request

Initializes the HUB into Sensor Pairing Mode by the thingName of the hub. The HUB's LED colour will change to a flashing green during Pairing Mode, and will return to a steady blue when no longer in Pairing Mode. A longer timeout can be short circuited to a shorter one by making a subsequent call with a shorter timeout.

Path
HUB_THING_NAMEstringrequired

A Hub ThingName, must be prefixed with HUB_

Bodyapplication/json
timeoutinteger[ 1 .. 3600 ]

Timeout value in seconds.

curl -i -X POST \
  'https://docs.cognitivesystems.com/_mock/assets/specs/api/app_cloud/sensors/pair/{HUB_THING_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "timeout": 60
  }'

Responses

201 Created

Bodyapplication/json
Response
application/json
{
  "timeout": 60
}

Obtain Configuration for All Devices

Request

Once sensors are paired, this API retrieves the list of all devices (hubs and sensors) associated to the WiFi Motion™ network. Calling this API synchronizes and updates sensor and hub states from the ThirdReality cloud.

curl -i -X GET \
  https://docs.cognitivesystems.com/_mock/assets/specs/api/app_cloud/sensors/devices

Responses

200 OK

Bodyapplication/json
Response
application/json
{
  "devices": [
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … }
  ]
}