Skip to content

Cognitive Systems App Cloud API

The App Cloud APIs expose the Core API endpoints, but with the addition of adding per user authentication and authorization. For example, you may choose to build with App Cloud APIs when developing for a mobile platform.

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

Geofencing Event (iOS)

Request

Endpoint used by Wifi Motion App to report user location and, if enabled, auto update network scene settings.

Security
Authorization
Bodyapplication/json
presence_eventsArray of objects
Example: [{"networkId":28,"timestamp":1598910716.216094,"is_arriving":false}]
network_idinteger
Example: 28
curl -i -X POST \
  https://docs.cognitivesystems.com/_mock/assets/specs/api/app_cloud/bulk_user_presences \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "presence_events": [
      {
        "networkId": 28,
        "timestamp": 1598910716.216094,
        "is_arriving": false
      }
    ],
    "network_id": 28
  }'

Responses

Bodyapplication/json
failuresArray of strings
Example: [{"timestamp":1603895421.6,"is_arriving":false,"network_id":2}]
Response
application/json
{
  "failures": [
    { … }
  ]
}

Geofencing Event (Android)

Request

Endpoint used by Wifi Motion App to report user location and, if enabled, auto update network scene settings. Only sends one location update instead of multiple.

Security
Authorization
Bodyapplication/json
network_idinteger>= 0
is_arrivingbooleanrequired
timestampnumberrequired
curl -i -X POST \
  https://docs.cognitivesystems.com/_mock/assets/specs/api/app_cloud/user_presences \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_id": 0,
    "is_arriving": true,
    "timestamp": 0
  }'

Responses

Bodyapplication/json
failuresArray of objects
Response
application/json
{
  "failures": [
    { … }
  ]
}

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

Sensor Integration is the process where a standalone sensor (like a Motion Tag or Bath Sensor) establishes a secure communication link with the WiFi Motion Plug network.

Operations