Autenticación y tenants

Envíe su clave en el encabezado X-API-Key en cada solicitud. Cada clave está vinculada a un solo tenant, y se rechaza cualquier solicitud que indique otro tenant.

La clave

Cada solicitud incluye su clave en el encabezado X-API-Key. TrackFlo emite las claves, una por tenant y por sistema (su integración con TMS recibe una; un espacio de trabajo de Front tiene la suya). El texto sin cifrar se muestra una sola vez al emitirla y no se puede recuperar: si la pierde o se filtra, solicite a TrackFlo que la desactive y emita una nueva. La desactivación surte efecto en un plazo de 60 segundos.

Falta la clave o esta no se reconoce → 401 {"error": "Unauthorized"}.

Tenants

Una clave está vinculada exactamente a un tenant, identificado por su company_permalink (su slug, por ejemplo, acme). Cada solicitud se comprueba con respecto a ese tenant:

• El company_permalink del cuerpo debe coincidir con el tenant de la clave.

• Cada *_permalink del cuerpo o de la URL debe terminar en -<company_permalink>.

Una solicitud que indique otro tenant → 403 {"error": "Forbidden"}. No se escribe nada.

Rotación

Solicite a TrackFlo una segunda clave, cambie su servicio para usarla y, después, haga que se desactive la primera. Dos claves activas por nombre es el proceso de rotación compatible.