Connect external applications to measurements, sites, reports and maintenance.
The external API provides scoped access to measurements, sites, reports and maintenance operations. The base path is https://unify.eniris.com/bff/ext/v1.
Use the live OpenAPI specification for request bodies, parameters and response formats.
Send an API key as Authorization: Bearer <key> or in the x-api-key header. Access depends on the key's account, permitted sites, capabilities and the current permissions of its owner.
| Capability | Purpose |
|---|---|
| telemetry | Read measurements, meters, assets and KPIs |
| sites:write | Create sites |
| reports | Read reports and generated results |
| reports:write | Create or change reports and request generation; requires reports |
| operations | Read maintenance and operational information |
| operations:write | Change operational data and run operational calculations; requires operations |
GET /buildings, then GET /buildings/{id}/meters and GET /series for measurements.GET /sites/{id}/assets, /kpis or /messages for equipment context./reports and the generation, runs and PDF routes to automate reporting./work-orders, /incidents and /sites/{id}/operations for operational follow-up.Series requests accept start and end times, an aggregation bucket and up to 20 meters, with a maximum period of three years. Use returned units and distinguish missing values from zero.
Read the current object before a versioned update. Site operations require the current revision; work-order commands require the current version. On a conflict, read again and reconcile the intended change.
A 401 indicates an invalid key; a 403 indicates insufficient access. A 503 can require the key owner to sign in again and select the account. Measurement routes are read-only: telemetry access does not grant device control.