API de sensores
Acceso de solo lectura a las lecturas de sensores y al historial de presencia de tu vivienda EVA Home. El token de acceso te lo entrega tu administrador y puede revocarlo cuando quiera.
Autenticación
Toda petición debe incluir tu token en la cabecera Authorization. El token identifica tu vivienda — no hace falta ningún otro identificador.
Authorization: Bearer eva_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
URL base
https://evahome.app/api/public/v1
Endpoints
GET /sensors
Última lectura de cada zona de la vivienda (temperatura, humedad, presencia, apertura de puertas… según lo instalado).
curl https://evahome.app/api/public/v1/sensors \ -H "Authorization: Bearer eva_live_xxxxxxxx"
[
{
"zone": "Salón",
"sensors": ["temperature", "presence"],
"temperature": 21.4,
"humidity": 48
},
{
"zone": "Dormitorio",
"sensors": ["presence"]
}
]
GET /history
Historial de entradas y salidas registradas por zona.
| Parámetro | Tipo | Descripción |
|---|---|---|
limit | entero | Nº máx. de registros — por defecto 50, máx. 200 |
date | AAAA-MM-DD | Filtra por un día concreto en vez de usar limit |
curl "https://evahome.app/api/public/v1/history?limit=20" \ -H "Authorization: Bearer eva_live_xxxxxxxx"
[
{
"zone": "Cocina",
"entered_at": "2026-08-15T09:12:03",
"exited_at": "2026-08-15T09:24:51",
"duration_minutes": 12
}
]
Límites y errores
| Código | Significado |
|---|---|
| 401 | Token inválido, ausente o revocado |
| 429 | Límite de peticiones excedido — 60 por minuto y token |
| 200 | Petición correcta |
Alcance
Esta API es de solo lectura. Devuelve únicamente datos de sensores e historial de presencia de tu propia vivienda — nunca datos de contacto, dirección ni facturación. Un token solo puede leer los datos de la instalación para la que fue creado.