Integración e API
O dato ten que entrar onde xa traballas
Un portal máis ao que ninguén mira non resolve nada. A posición publícase para que aterre no mapa operacional e no xestor de incidencias que o teu equipo xa ten aberto.
Interfaces dispoñibles
| Interface | Para que | Modo |
|---|---|---|
| API REST | Consultar posicións, equipos, alertas e históricos | Petición baixo demanda |
| Webhooks | Recibir eventos en canto ocorren: cambios de posición, alertas, entradas e saídas de zona | Envío saínte |
| Exportación programada | Envorcados periódicos para análise e planificación | CSV / JSON |
A autenticación é por credencial de servizo con ámbito acoutado e rotación de claves. Todo o tráfico vai sobre TLS, con límite de taxa por credencial e as proteccións habituais fronte aos riscos típicos de API.
Como se ve unha posición
Este é o evento que recibe o teu sistema cando un equipo cambia de posición. O importante non é a coordenada: é que vén acompañada da súa calidade, para que quen a consome poida decidir canto 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
}
}zoneeareason a lectura operativa: estación e recinto. Adoita ser o único que necesita o xestor de incidencias.xeyson coordenadas no sistema local do emprazamento, para pintar sobre o plano.accuracy_mé o raio de incerteza estimado desa lectura concreta, non unha constante do sistema.onboardaparece só cando o axente vai nun tren e a capa a bordo está despregada. É unha identificación exacta, non unha estimación: se o obxecto non está, é que non se está a ler ningunha baliza de coche.nlos_suspectedavisa de que a medida puido chegar rebotada.map_matchedindica se a posición se axustou ao plano transitable.
Goberno do dato
- Contratos de datos versionados: os cambios de esquema anúncianse e conviven, non rompen a túa integración un martes.
- Retención configurable por tipo de dato, segundo a política do operador.
- Anonimización e pseudonimización aplicables nos fluxos que non necesitan identificar a persoa.
- Portabilidade: o histórico expórtase completo cando se pida. O dato é do operador.
Para un integrador de sinalización, CCTV ou comunicacións, esta é a páxina que importa: se a API é limpa, meter Metrosafe nun cadro de mando existente é traballo de días, non de meses.
Queres a documentación da API?
Dinos con que sistema queres integralo e pasámosche a especificación completa e unha contorna de probas.
- +34 924 090 608
- [email protected]
- Campus Universitario, Avda. de la Investigación S/N, Edificio PCTEX, Oficina 2.1
06006 Badajoz