Public API v1

API de Integración para Tracking de Contenedores

Conecta tu TOS, ERP o sistema propio con ContainerFlow para consultar el estado y la trazabilidad de contenedores en tiempo real. REST sobre HTTPS, autenticación simple por API key — sin SDK propietario.

Dos superficies de API distintas

App interna (dashboard)

Autenticación con Firebase Auth (JWT), multi-tenant estricto por empresa y control de acceso por rol (Administrador, Gerente, Portero, Conductor, Operador de Grúa). Es la API que sostiene el dashboard de ContainerFlow — no está pensada para integraciones de terceros.

Public API v1 (esta página)

Pensada para que sistemas externos — otro TOS, un ERP logístico, una planilla interna — consulten información de contenedores sin necesidad de operar dentro del dashboard.

Qué expone hoy

Los contenedores se identifican con su código ISO 6346 estándar. Todos los endpoints son de solo lectura (GET).

GET/containers/{code}/statusEstado actual del contenedor.
GET/containers/{code}/trackingTracking en tiempo real, según el estándar DCSA Track & Trace, con datos de la naviera cuando está disponible.
GET/containers/{code}/historyHistorial de eventos del contenedor.

Autenticación

Cada request lleva el header X-API-Key con tu clave. No usa OAuth ni JWT — es una API key simple, pensada para que cualquier sistema que pueda hacer un GET con headers personalizados se integre sin fricción.

X-API-Key: cf_live_xxxxxxxx

Hoy la obtención de la key es un proceso asistido: no existe todavía un signup self-service. Solicita el acceso y nuestro equipo te la entrega.

Solicitar acceso a la API

Ejemplo de request

curl https://api.containerflow.cl/v1/containers/MSCU2847163/status \
  -H "X-API-Key: cf_live_xxxxxxxx"

Condiciones de operación

  • REST sobre HTTPS, respuestas en JSON.
  • Límite de 30 solicitudes por minuto por IP en la Public API v1 (la API interna del dashboard tiene un límite distinto, 100/min, que no aplica a integraciones externas).
  • Cada llamada exitosa se mide y factura automáticamente. Existen 3 planes — Starter, Business y Enterprise — diferenciados por volumen de uso.

Qué necesita tu sistema para conectarse

  • Poder hacer requests HTTPS salientes y parsear JSON. No se requiere ningún SDK propietario: cualquier sistema (TOS, ERP, planilla interna) que pueda hacer un GET con headers custom puede integrarse.
  • Respetar el límite de 30 req/min, implementando reintentos con backoff — al superarlo, la API responde con el código HTTP estándar 429 (Too Many Requests).
  • Si las llamadas se originan desde el navegador del usuario final (no servidor-a-servidor), el dominio debe estar en una whitelist de CORS que configuramos junto a ti. Para integraciones server-to-server esto no aplica.

Qué no está disponible todavía

  • Webhooks o notificaciones push: hoy todo es request/response — tu sistema consulta, ContainerFlow no envía eventos automáticos.
  • Tracking en vivo garantizado para todas las navieras: depende de que cada naviera apruebe el acceso, un proceso en curso, no activo para todas.
  • Planificación de patio o grúa vía API: esa funcionalidad vive en la app interna y no está lista para producción.

¿Listo para conectar tu sistema?

Contanos qué sistema quieres integrar (TOS, ERP, planilla) y te enviamos las credenciales de acceso.

Solicitar acceso a la API