Integración y API
El dato tiene que entrar donde ya trabajas
Un portal más al que nadie mira no resuelve nada. La posición se publica para que aterrice en el mapa operacional y en el gestor de incidencias que tu equipo ya tiene abierto.
Interfaces disponibles
| Interfaz | Para qué | Modo |
|---|---|---|
| API REST | Consultar posiciones, equipos, alertas e históricos | Petición bajo demanda |
| Webhooks | Recibir eventos en cuanto ocurren: cambios de posición, alertas, entradas y salidas de zona | Envío saliente |
| Exportación programada | Volcados periódicos para análisis y planificación | CSV / JSON |
La autenticación es por credencial de servicio con ámbito acotado y rotación de claves. Todo el tráfico va sobre TLS, con límite de tasa por credencial y las protecciones habituales frente a los riesgos típicos de API.
Cómo se ve una posición
Este es el evento que recibe tu sistema cuando un equipo cambia de posición. Lo importante no es la coordenada: es que viene acompañada de su calidad, para que quien la consume pueda decidir cuánto se fía.
{
"event": "position.updated",
"timestamp": "2026-03-11T09:41:07Z",
"terminal": {
"id": "TRM-0043",
"team": "vigilancia-l2-turno-manana"
},
"position": {
"zone": "station-014",
"area": "platform",
"direction": "north",
"x": 128.4,
"y": 22.7,
"srs": "site-local"
},
"onboard": {
"train": "4207",
"car": 3
},
"quality": {
"accuracy_m": 6.8,
"source": "wifi-rtt",
"nlos_suspected": false,
"map_matched": true
}
}zoneyareason la lectura operativa: estación y recinto. Suele ser lo único que necesita el gestor de incidencias.xeyson coordenadas en el sistema local del emplazamiento, para pintar sobre el plano.accuracy_mes el radio de incertidumbre estimado de esa lectura concreta, no una constante del sistema.onboardaparece solo cuando el agente va en un tren y la capa a bordo está desplegada. Es una identificación exacta, no una estimación: si el objeto no está, es que no se está leyendo ninguna baliza de coche.nlos_suspectedavisa de que la medida pudo llegar rebotada.map_matchedindica si la posición se ha ajustado al plano transitable.
Gobierno del dato
- Contratos de datos versionados: los cambios de esquema se anuncian y conviven, no rompen tu integración un martes.
- Retención configurable por tipo de dato, según la política del operador.
- Anonimización y seudonimización aplicables en los flujos que no necesitan identificar a la persona.
- Portabilidad: el histórico se exporta completo cuando se pida. El dato es del operador.
Para un integrador de señalización, CCTV o comunicaciones, esta página es la que importa: si la API es limpia, meter Metrosafe en un cuadro de mando existente es trabajo de días, no de meses.
¿Quieres la documentación de la API?
Dinos con qué sistema quieres integrarlo y te pasamos la especificación completa y un entorno de pruebas.
- +34 924 090 608
- [email protected]
- Campus Universitario, Avda. de la Investigación S/N, Edificio PCTEX, Oficina 2.1
06006 Badajoz