API REST IoT de Temperatura y APPCC para Integradores de Software
Conecta la telemetría en tiempo real de GEYBOS con tu ERP, GMAO, BMS o plataforma de hostelería. Sin desarrollar hardware, sin desplegar infraestructura de radiofrecuencia y con trazabilidad oficial lista para auditorías sanitarias.
Resumen de la API para integradores y CTOs
La API REST de GEYBOS permite a desarrolladores y fabricantes de software consultar lecturas en tiempo real de temperatura, humedad y consumo energético, extraer series temporales históricas, sincronizar incidencias e invocar la generación automática de informes oficiales en PDF (APPCC y RD 487/2022 de legionela). Funciona bajo el estándar HTTPS/JSON, con autenticación mediante API Key con prefijo identificativo, control de scopes granulares y cifrado TLS 1.3.
Casos de uso: integra GEYBOS en tu plataforma
ERPs y Gestión Empresarial
Compatibilidad: SAP, Microsoft Dynamics 365, Sage, Odoo, Cegid
Asocia las curvas de temperatura de conservación y transporte a lotes específicos de producción y albaranes de entrega de alimentos o medicamentos.
GMAO y Mantenimiento (CMMS)
Compatibilidad: Fracttal, IBM Maximo, Mobility Work, MaintainX
Apertura automática de órdenes de trabajo preventivas y correctivas en el momento exacto en que una cámara frigorífica o caldera ACS sale de su rango operativo.
BMS, SCADA y Control de Edificios
Compatibilidad: Schneider EcoStruxure, Siemens Desigo, Johnson Controls
Supervisión unificada en un solo monitor de cámaras frigoríficas, túneles de frío y sistemas de agua caliente sin necesidad de cableado adicional.
TPV y Software de Cocina
Compatibilidad: Hosteltáctil, Agora, Revo, Last.app, Hiopos
Incorpora el módulo de registro de temperaturas obligatorio del APPCC dentro del software de gestión habitual de restaurantes y cocinas centrales.
Especificación técnica de endpoints
Todas las respuestas se devuelven en formato JSON estructurado con codificación UTF-8 y sellos de tiempo en estándar ISO 8601 en horario universal (UTC).
| Método | Ruta | Descripción | Permiso (Scope) |
|---|---|---|---|
| GET | /v1/me | Estado de la clave API, scopes activos, empresa asignada y consumo mensual acumulado. | Cualquiera |
| GET | /v1/telemetry/live | Última lectura en tiempo real de todos los sensores asignados (temperatura, humedad, batería y estado de señal). | read |
| GET | /v1/telemetry/query | Series temporales históricas con filtros por rango de fechas (hasta 92 días) y agregación por intervalos de 15m, 1h o 1d. | read |
| GET | /v1/alarms | Listado de incidencias y desvíos térmicos registrados, con estado de resolución y marcas de tiempo. | read |
| POST | /v1/alarms/{id}/resolve | Resolución y registro de acciones correctivas sobre alarmas desde un sistema externo (GMAO / ERP). | alarms:write |
| GET | /v1/reports/appcc.pdf | Generación directa de informe oficial de temperaturas para auditorías sanitarias con sello de tiempo en formato PDF. | reports |
| GET | /v1/energy/locations/{id}/summary | Métricas de consumo energético, potencia activa y costes calculados por ubicación. | energy |
Ejemplo de integración rápida
Consulta de telemetría en tiempo real mediante cURL con autenticación Bearer:
curl -X GET "https://api.geybos.com/v1/telemetry/live" \ -H "Authorization: Bearer gb_live_tu_clave_de_api_secreta" \ -H "Accept: application/json"
{
"status": "success",
"data": [
{
"sensor_id": "SN-849201",
"name": "Cámara de Congelación 01",
"temperature_celsius": -19.4,
"humidity_percentage": 68.2,
"battery_percentage": 96,
"status": "OK",
"timestamp": "2026-11-08T10:30:00Z"
},
{
"sensor_id": "SN-849202",
"name": "Acumulador ACS Legionela",
"temperature_celsius": 61.8,
"humidity_percentage": null,
"battery_percentage": 92,
"status": "OK",
"timestamp": "2026-11-08T10:30:00Z"
}
]
}Seguridad empresarial y gobernanza de datos
Cifrado de extremo a extremo
Comunicaciones protegidas mediante TLS 1.3. Las claves de API se almacenan con funciones de hash criptográfico unidireccional y nunca se exponen en texto plano tras su emisión.
Restricción por IP / CIDR
Opción de vincular tus claves de integración a direcciones IP estáticas o rangos de red corporativos autorizados para evitar usos indebidos fuera de tu infraestructura.
Permisos por Scopes
Principio de mínimo privilegio: segrega accesos de solo lectura para cuadros de mando frente a generación de informes o resolución de alarmas en planta.
Por qué integrar la tecnología IoT de GEYBOS
- ✔Cero inversión en hardware propietario: Nuestros sensores y pasarelas están homologados, no requieren cableado ni obras y cuentan con hasta 2,5 años de batería.
- ✔Trazabilidad legal certificada: Informes con sello de tiempo que cumplen de forma estricta las exigencias del Reglamento (CE) 852/2004 (APPCC) y del RD 487/2022 (prevención y control de legionela).
- ✔Resiliencia ante caídas de red: Almacenamiento local en los propios sensores que se sincroniza sin pérdidas ante fallos de conexión a internet.
- ✔Entorno Sandbox y soporte técnico directo: Acompañamos a tu equipo de desarrollo durante todo el proceso de homologación e integración.
¿Desarrollas software para hostelería, industria o salud?
Solicita credenciales de prueba y convierte tu plataforma en una solución completa con telemetría IoT y certificación APPCC automática.
Solicitar acceso a la API →Preguntas frecuentes sobre la API
¿Qué es la API de GEYBOS y para qué sirve?
La API de GEYBOS es una interfaz RESTful que permite a integradores de software, ERPs, sistemas GMAO/CMMS y plataformas BMS conectar directamente con nuestra red de sensores IoT. Proporciona telemetría en tiempo real de temperatura, humedad y consumo energético, acceso a series históricas agregadas, gestión y resolución de alarmas, y generación de informes oficiales de cumplimiento APPCC y del RD 487/2022 en PDF.
¿Cómo se autentican las peticiones a la API?
La autenticación se realiza mediante cabeceras HTTP estándar utilizando una clave de API segura (Bearer Token con prefijo identificativo gb_). Cada clave cuenta con permisos granulares (scopes), control de cuota mensual, rate limiting configurable y puede restringirse opcionalmente a listas de direcciones IP o rangos CIDR autorizados.
¿Qué tipo de softwares se pueden integrar con GEYBOS?
Cualquier aplicación capaz de realizar peticiones HTTPS estándar: ERPs (como SAP, Navision, Sage, Odoo), sistemas de gestión de mantenimiento GMAO, BMS/SCADA de control de edificios e instalaciones, software de punto de venta (TPV) para hostelería, plataformas de auditoría de calidad y cuadros de mando corporativos.
¿Qué sucede si hay una pérdida de conexión a internet en la instalación?
Los sensores GEYBOS disponen de memoria interna de almacenamiento local (hasta 200 registros en sensores ambientales y hasta 20.480 lecturas en sondas de inmersión). Si el router o la conexión sufren un corte temporal, los dispositivos almacenan las mediciones y la pasarela las sincroniza de forma automática e íntegra en cuanto se restablece la comunicación, garantizando series continuas sin vacíos para la inspección.
¿Qué límites de peticiones (rate limits) aplican a los integradores?
El servicio cuenta con políticas de protección activas mediante cabeceras estándar RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset. Los límites estándar se adaptan al plan de integración del partner (por defecto 120 peticiones por minuto para consultas de telemetría y límites dedicados para la generación asíncrona de informes en PDF), ampliables según las necesidades de la infraestructura del cliente.
¿Cómo solicitar acceso para desarrolladores y claves de prueba?
Puedes solicitar acceso al programa de Partners e Integradores poniéndote en contacto con nuestro equipo técnico a través de nuestro formulario de contacto o en info@geybos.com. Proporcionamos soporte directo de integración y entorno sandbox para validación.