Skip to main content

Device API

Endpoints

RouteMethodPurpose
/api/v1/devices/GETList user's devices with groups & feeds
/api/v1/devices/POSTCreate new device
/api/v1/devices/{id}PUTUpdate device properties
/api/v1/devices/{id}DELETEDelete device
/api/v1/groups/GETList device groups
/api/v1/groups/POSTCreate group

Data Models

Device

Device:
- id (UUID, primary)
- key (string, unique per user)
- device_code (string, unique, generated)
- name, description
- status (online|offline|warning|error|inactive)
- location (latitude, longitude, elevation, address)
- telemetry (temperature, humidity, last_seen)
- configuration (JSON, customizable)
- relationships: User, Groups, Feeds, Schedules

Group (Device Collection)

Group:
- id (UUID)
- key, name
- user_id (FK)
- many-to-many: Devices