Integración Genérica SITIA Legada

Guía del método legado para enviar eventos de detección vehicular (SPD SITIA v1/v2) hacia la plataforma SITIA

Eventos deprecados

Estos eventos de la API están deprecados. Aunque siguen soportados para compatibilidad, las nuevas integraciones no deben utilizarlos y serán removidos en el futuro. Recomendamos migrar a la Nueva Integración Genérica basada en CloudEvents 1.0.

Descripción General

Este documento describe el método de integración legada de SITIA para el envío de eventos de detección de vehículos.

Autenticación

Token Bearer provisto por el equipo de soporte de SITIA Patentes.
Incluya el token en la cabecera Authorization en cada solicitud.

Estructura del Evento (CloudEvents)

Los eventos deben cumplir con la especificación CloudEvents 1.0 (formato JSON estructurado):

specversion: "1.0"
type: tipo del evento admitido
source: origen URI-referenciable de su sistema
id: identificador único del evento (recomendado UUID v4/v7)
time: fecha/hora en ISO 8601 / RFC3339
datacontenttype: siempre application/json
data: carga específica del evento

Tipos de eventos admitidos por la plataforma:

spd.sitia.vehicle.detected.v1 — Detecta vehículo desde una cámara LPR/ANPR
spd.sitia.vehicle.detected.v2 — Detecta vehículo en punto de control de tráfico
spd.sitia.vehicle.detected.v3 — Detecta vehículo con georreferenciación

Ejemplos de Solicitudes

Evento único

POST https://sandboxsapp.carabineros.cl/api/integration-test/events/vehicle-detected
Accept: Application/json
Content-Type: Application/json
Authorization: Bearer {{token}}

{
  "specversion": "1.0",
  "type": "spd.sitia.vehicle.detected.v2",
  "source": "/codigo-productor-datos/sistema-1/lpr",
  "id": "unique-event-id",
  "time": "2024-04-05T17:31:00Z",
  "datacontenttype": "application/json",
  "data": {
    "license_plate": "ABC123",
    "traffic_control_point": "AB1",
    "timestamp": "2024-04-05T17:31:00Z"
  }
}

Eventos en lote

POST https://sandboxsapp.carabineros.cl/api/integration-test/events/vehicle-detected
Accept: Application/json
Content-Type: Application/json
Authorization: Bearer {{token}}

[
  {
    "specversion": "1.0",
    "type": "spd.sitia.vehicle.detected.v2",
    "source": "/codigo-productor-datos/sistema-1/lpr",
    "id": "unique-event-id",
    "time": "2024-04-05T17:31:00Z",
    "datacontenttype": "application/json",
    "data": {
      "license_plate": "ABC123",
      "traffic_control_point": "AB1",
      "timestamp": "2024-04-05T17:31:00Z"
    }
  },
  {
    "specversion": "1.0",
    "type": "spd.sitia.vehicle.detected.v3",
    "source": "/codigo-productor-datos/sistema-1/control-manual",
    "id": "unique-event-id",
    "time": "2024-04-05T17:31:00Z",
    "datacontenttype": "application/json",
    "data": {
      "license_plate": "ABC123",
      "latitude": -33.4567,
      "longitude": -70.6489,
      "timestamp": "2024-04-05T17:31:00Z"
    }
  }
]

Reglas y Buenas Prácticas

La combinación source + id debe ser única por evento.
Respete los formatos de tiempo ISO 8601 / RFC3339.
Use application/json en cabecera y datacontenttype.
Para lotes, cada elemento debe ser un CloudEvent válido.