Problemas Comunes y FAQ

Problemas Comunes

1. Error 401 Unauthorized

• Causa Posible: La API Key o el token OAuth2 es incorrecto, ha expirado o no se está enviando en la cabecera Authorization correctamente.
• Solución:
  • Verifique que está usando las credenciales correctas para el ambiente (Sandbox o Producción).
  • Asegúrese de que la cabecera sea Authorization: Bearer <su_token>.
  • Si usa OAuth2, asegúrese de que el token no haya expirado y renuévelo si es necesario.
  • Confirme que su IP de origen está en la allowlist de SITIA.

2. Error 400 Bad Request

• Causa Posible: El cuerpo de la petición (payload) tiene un formato incorrecto o le falta un campo obligatorio.
• Solución:
  • Valide su payload contra el esquema CloudEvents y la definición de eventos de SITIA.
  • Revise el cuerpo de la respuesta de error, a menudo contiene un mensaje detallado indicando qué campo es el problemático.
  • Asegúrese de que todos los campos obligatorios estén presentes.

3. Error 404 Not Found

• Causa Posible: Está intentando acceder a un endpoint que no existe o, más comúnmente, el source (ID de la cámara) en su evento no está registrado en el inventario de SITIA.
• Solución:
  • Verifique la URL del endpoint al que está llamando.
  • Asegúrese de que el valor del campo source en su evento coincida exactamente con el "Nombre interno de la cámara" que proveyó en el formulario de registro.

4. Error 409 Conflict

• Causa Posible: Está intentando enviar un evento con un id que ya ha sido procesado para el mismo source.
• Solución:
  • Asegúrese de que cada evento nuevo tenga un identificador único (id). No reutilice IDs de eventos.

5. La conexión falla (Timeout)

• Causa Posible: Problemas de red, un firewall bloqueando la conexión o un problema con los certificados TLS.
• Solución:
  • Verifique su conexión a internet.
  • Asegúrese de que su firewall de salida permita conexiones al dominio *.carabineros.cl y *sitia.gob.cl en el puerto 443.
  • Su cliente HTTP debe ser compatible con TLS 1.3 y validar correctamente el certificado presentado por el servidor de SITIA.

Preguntas Frecuentes (FAQ)

P: ¿Necesito generar mi propio certificado SSL/TLS? R: No. La comunicación es iniciada por su cliente hacia los servidores de SITIA. Solo necesita asegurarse de que su cliente valide correctamente el certificado TLS que nuestros servidores presentan.

P: ¿Cuánto tiempo tardan en aprobar mi registro de productor? R: El proceso de revisión y validación inicial toma entre 3 y 5 días hábiles una vez que hemos recibido el formulario completo.

P: ¿Puedo usar la misma API Key para Sandbox y Producción? R: No. Se proporcionan credenciales separadas y únicas para cada ambiente. Las credenciales de Sandbox no funcionarán en Producción y viceversa.

P: ¿Qué pasa si una de mis cámaras cambia de ubicación? R: Debe notificar al equipo de SITIA actualizando la información en su inventario de cámaras para mantener la consistencia de los datos.

P: ¿Existe un límite en la cantidad de eventos que puedo enviar? R: Sí, existen límites de tasa (rate limiting) para proteger la plataforma. Si planea un envío masivo de datos o espera un volumen de tráfico muy alto, por favor coordínelo previamente con el equipo de SITIA. Si excede el límite, recibirá un error 429 Too Many Requests.