Device API
Endpoints
| Route | Method | Purpose |
|---|---|---|
/api/v1/devices/ | GET | List user's devices with groups & feeds |
/api/v1/devices/ | POST | Create new device |
/api/v1/devices/{id} | PUT | Update device properties |
/api/v1/devices/{id} | DELETE | Delete device |
/api/v1/groups/ | GET | List device groups |
/api/v1/groups/ | POST | Create 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