API & Integrations
RESTful API Architecture
The platform exposes a comprehensive REST API for device telemetry ingestion, dashboard data retrieval, alert/incident management, and mobile app support. All endpoints return JSON with a standard envelope format.
Telemetry Ingestion
POST endpoint accepts sensor data with device token authentication. Supports all 6 solution modules.
Dashboard APIs
GET endpoints for devices, alerts, incidents, and reports. Supports filtering and pagination.
Mobile APIs
Stateless Bearer token authentication for mobile apps. Login returns a 64-char hex token.
Webhook Support
Configure outbound webhooks for incident creation, alert triggers, and device status changes.
📡 Standard Response Envelope
// Success
{ "status": "ok", "data": { ... } }
// Error
{ "status": "error", "message": "Invalid token", "code": 401 }
🔌 Integration Patterns
IoT devices authenticate via X-Device-Token header and POST telemetry. Mobile apps use Authorization: Bearer <token> for all operations. Web dashboards use session-based auth with CSRF protection. All three authentication paths converge on the same data layer.