Saltar ao contido

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

InterfacePara queModo
API RESTConsultar posicións, equipos, alertas e históricosPetición baixo demanda
WebhooksRecibir eventos en canto ocorren: cambios de posición, alertas, entradas e saídas de zonaEnvío saínte
Exportación programadaEnvorcados periódicos para análise e planificaciónCSV / 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
  }
}
  • zone e area son a lectura operativa: estación e recinto. Adoita ser o único que necesita o xestor de incidencias.
  • x e y son 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.
  • onboard aparece 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_suspected avisa de que a medida puido chegar rebotada.
  • map_matched indica 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.

Respondemos en menos de 24 horas laborables.