IoT Integrations

The Total Access IoT module provides a unified API for connecting to smart device platforms (Tuya, Google Home, and others) and managing IoT devices within your organisation.

Overview

IoT integration works through OAuth providers — each platform (e.g. Tuya) is registered as a provider with its own OAuth credentials. Users connect their accounts, and the API syncs devices back into Total Access.

List IoT providers

See which IoT platforms are available:

curl -X GET https://developer.totalaccess.co.za/api/v1/iot/providers \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response:

{
  "success": true,
  "data": [
    {
      "id": 1,
      "provider_key": "tuya",
      "display_name": "Tuya Smart",
      "description": "Connect Tuya smart home devices",
      "is_active": true
    }
  ]
}

List IoT connections

View existing provider connections for your client:

curl -X GET https://developer.totalaccess.co.za/api/v1/iot/connections \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

List devices

Retrieve all IoT devices, with optional filters:

curl -X GET "https://developer.totalaccess.co.za/api/v1/iot/devices?is_online=true" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Filter parameters

Parameter	Type	Description
`connection_id`	integer	Filter by provider connection
`device_type`	string	Filter by device type (e.g. `switch`, `light`, `sensor`)
`room`	string	Filter by room name
`is_online`	boolean	Filter by online status

Sync devices

Trigger a device sync from a connected provider:

curl -X POST https://developer.totalaccess.co.za/api/v1/iot/devices \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": 3
  }'

Device sync is rate-limited per provider. Avoid calling more than once per minute.

Supported platforms

Platform	Status	Notes
Tuya Smart	Available	Full device sync and control
Google Home	Available	Device listing and status
Samsung SmartThings	Planned	Future release
Apple HomeKit	Planned	Future release

IoT Integrations

On this page