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.
Cognitive Systems App Cloud API
Download OpenAPI description
Languages
Servers
Mock server
https://docs.cognitivesystems.com/_mock/assets/specs/api/app_cloud/
https://docs.cognitivesystems.com/api/v1/
Request
Get or create a Wi-Fi Motion network in App Cloud. The Guardian Id is shared with Core when the network first comes online.
This endpoint verifies the existence of the user's network in Core and if it's claimable. If the network is present in Core, but not in App Cloud, the network is created.
Calling this endpoint has one of the following outcomes:
- Network not found in MNS Core (404)
- Network found, already in App Cloud and returned (200)
- Network found, not in App Cloud, created, and returned (200)
In the response object, claimed tells you whether the network has an owner.
If claimed is false, the network can be claimed by calling /api/v1/network_memberships. If claimed is true, the user can only be added as a member.
Security
Authorization
- Mock serverhttps://docs.cognitivesystems.com/_mock/assets/specs/api/app_cloud/find
- https://docs.cognitivesystems.com/api/v1/find
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.cognitivesystems.com/_mock/assets/specs/api/app_cloud/find \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"guardian_id": "string"
}'Response
application/json
{ "id": 0, "address": "string", "building_size": "string", "building_type": "string", "latitude": "string", "longitude": "string", "live_enabled": true, "name": "string", "pet_size": "string", "external_id": 0, "timezone": "string", "user_count": 0, "scene_id": 0, "created_at": "string", "updated_at": "string", "network_scene_config": {}, "claimed": true, "is_owner": true, "subscription_id": "string" }
- Mock serverhttps://docs.cognitivesystems.com/_mock/assets/specs/api/app_cloud/mobile_devices/{id}
- https://docs.cognitivesystems.com/api/v1/mobile_devices/{id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
'https://docs.cognitivesystems.com/_mock/assets/specs/api/app_cloud/mobile_devices/{id}' \
-H 'Authorization: YOUR_API_KEY_HERE'