API abierta y webhooks

SiGO expone una API REST documentada con OpenAPI que cubre las operaciones principales de la plataforma: consulta y creación de incidencias, órdenes de trabajo, activos del inventario, pesajes, partes, usuarios y catálogos. La documentación se mantiene al día y permite que cualquier desarrollo externo —un ERP, un portal corporativo, un sistema heredado del ayuntamiento— se integre sin tener que pedir acceso a la base de datos ni montar procesos de sincronización a medida.

El módulo añade webhooks salientes para notificar eventos a sistemas externos en el momento en que ocurren: nueva incidencia, cambio de estado, cierre de orden de trabajo, validación de parte, alerta de umbral. El sistema receptor recibe el payload, lo procesa y actúa sin tener que sondear continuamente la API.

Todos los accesos se controlan con tokens por cliente y un modelo de permisos granular por recurso y por operación. Se aplica rate limiting configurable por token y se audita cada llamada, con trazabilidad completa de quién hizo qué y cuándo.

Un caso de uso típico: una empresa concesionaria tiene su propio ERP corporativo y prefiere que sus equipos no entren a SiGO. Con la API y los webhooks, cada orden de trabajo que se abre en SiGO aparece automáticamente en el ERP de la concesionaria, y cada cambio de estado se sincroniza en tiempo real. El ciudadano, el ayuntamiento y la concesionaria trabajan sobre los mismos datos sin que nadie cambie de herramienta.