Referencia API

Autenticación

La API de seguimiento de eventos se autentica con un único token de registro enviado como cabecera - sin flujo OAuth, sin petición de login, sin caducidad.

Cabecera token

Toda petición a POST /v1/register/ debe incluir una cabecera token con el valor de tu token de registro:

http

token: your_organization_token
Content-Type: application/json

Un token ausente o inválido devuelve 401 Unauthorized.

Obtener tu token

Tu token de registro está disponible en el panel de Infini Analytics, en la página donde se gestiona tu organización. Es el mismo token que usa cada integración - el SDK de Python, las plantillas de PAD/PAC y n8n - así que solo necesitas copiarlo una vez.

El token está vinculado a tu organización, no a un automatismo concreto. Lo combinarás con un automation_id en el cuerpo de la petición para dirigir cada evento al automatismo correcto - consulta el Resumen.

Seguridad

Mantén en secreto tu token de registro - otorga acceso de escritura a todos los automatismos de tu organización. Guárdalo como variable de entorno o secreto, nunca lo subas al control de versiones y nunca lo expongas en código del lado del cliente.

A diferencia de los tokens de sesión de corta duración, este token no caduca por sí solo. Si alguna vez se expone, solicita uno nuevo desde la página de tu organización o al soporte de Infini.