Integració i API
La dada ha d’entrar on ja treballes
Un portal més que ningú no mira no resol res. La posició es publica perquè aterri al mapa operacional i al gestor d’incidències que el teu equip ja té obert.
Interfícies disponibles
| Interfície | Per a què | Mode |
|---|---|---|
| API REST | Consultar posicions, equips, alertes i històrics | Petició sota demanda |
| Webhooks | Rebre esdeveniments tan bon punt es produeixen: canvis de posició, alertes, entrades i sortides de zona | Enviament sortint |
| Exportació programada | Bolcats periòdics per a anàlisi i planificació | CSV / JSON |
L’autenticació és per credencial de servei amb àmbit acotat i rotació de claus. Tot el trànsit va sobre TLS, amb límit de taxa per credencial i les proteccions habituals davant dels riscos típics d’API.
Com es veu una posició
Aquest és l’esdeveniment que rep el teu sistema quan un equip canvia de posició. L’important no és la coordenada: és que ve acompanyada de la seva qualitat, perquè qui la consumeix pugui decidir fins a quin punt se’n fia.
{
"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
}
}zoneiareasón la lectura operativa: estació i recinte. Sol ser l’únic que necessita el gestor d’incidències.xiysón coordenades en el sistema local de l’emplaçament, per pintar sobre el plànol.accuracy_més el radi d’incertesa estimat d’aquesta lectura concreta, no una constant del sistema.onboardapareix només quan l’agent va en un tren i la capa a bord està desplegada. És una identificació exacta, no una estimació: si l’objecte no hi és, és que no s’està llegint cap balisa de cotxe.nlos_suspectedavisa que la mesura podria haver arribat rebotada.map_matchedindica si la posició s’ha ajustat al plànol transitable.
Govern de les dades
- Contractes de dades versionats: els canvis d’esquema s’anuncien i conviuen, no trenquen la teva integració un dimarts.
- Retenció configurable per tipus de dada, segons la política de l’operador.
- Anonimització i pseudonimització aplicables als fluxos que no necessiten identificar la persona.
- Portabilitat: l’històric s’exporta complet quan es demani. Les dades són de l’operador.
Per a un integrador de senyalització, CCTV o comunicacions, aquesta és la pàgina que importa: si l’API és neta, posar Metrosafe en un quadre de comandament existent és feina de dies, no de mesos.
Vols la documentació de l’API?
Digues-nos amb quin sistema el vols integrar i et passem l’especificació completa i un entorn de proves.
- +34 924 090 608
- [email protected]
- Campus Universitario, Avda. de la Investigación S/N, Edificio PCTEX, Oficina 2.1
06006 Badajoz