Referencia API

Resumen

La API de seguimiento de eventos de InfiniAnalytics permite que cualquier automatismo - sin importar el lenguaje o la plataforma - registre el ciclo de vida de una ejecución a través de un único endpoint.

URL Base

Todas las peticiones se hacen a:

url

https://api.analytics.infini.es

Usa siempre HTTPS. Una petición HTTP plana se redirige con un HTTP 301 a la URL HTTPS en lugar de procesarse.

Endpoints

Endpoint	Propósito
POST`/v1/register/`	Registra un `START`, `EVENT`, `WARNING`, `END` o `ERROR` para una ejecución. Este es el único endpoint que necesita la mayoría de las integraciones.
`/v1/ping/`	Comprobación de conectividad ligera - úsalo para confirmar que tu token y el acceso de red funcionan antes de conectar la integración real.

Formato de Petición

Las peticiones y respuestas usan JSON. Establece Content-Type: application/json e incluye tu token de organización en una cabecera token (consulta Autenticación):

bash

curl --location 'https://api.analytics.infini.es/v1/register/' \
  --header 'Content-Type: application/json' \
  --header 'token: your_organization_token' \
  --data '{
    "automation_id": "3571c1e0-88b9-4104-a0b0-f060b7fcc6eb",
    "execution_id": "2025-03-03T15:32:17.571404",
    "event": "START",
    "description": "Starting the process"
  }'

Ejemplo de respuesta (HTTP 201):

json

{
  "automation": "3571c1e0-88b9-4104-a0b0-f060b7fcc6eb",
  "execution_id": "2025-03-03T15:32:17.571404",
  "type_of_event": "START",
  "description": "Starting the process",
  "error_id": "",
  "error_description_detail": "",
  "created_at": "2025-03-03T16:00:29.998530Z"
}

Campos

Campo	Obligatorio	Descripción
`automation_id`	Sí	El UUID de tu automatismo en el panel de InfiniAnalytics.
`execution_id`	Sí	Un identificador único de esta ejecución que defines tú - reutilízalo en todos los eventos de la misma ejecución. Sirve tanto un ID interno de tu sistema como una marca de tiempo ISO 8601, siempre que no coincida con una ejecución concurrente.
`event`	Sí	Uno de START, EVENT, WARNING, END o ERROR.
`description`	No	Texto libre que describe el evento.
`error_id`	No	Un identificador de error. Solo tiene sentido cuando event es ERROR.
`error_description`	No	Mensaje de error detallado (p. ej. el mensaje de una excepción). Solo tiene sentido cuando event es ERROR.

Respuestas

Estado	Significado
`201`	Created - el evento se registró correctamente.
`301`	Moved Permanently - la petición se hizo por HTTP plano; reinténtala por HTTPS.
`401`	Unauthorized - falta la cabecera token o no es válida.
`5xx`	Server Error - un problema transitorio de nuestro lado. Contacta con el soporte de Infini si persiste.

Referencia Completa

Para una referencia completa, endpoint por endpoint, de los cinco eventos (START, EVENT, WARNING, ERROR y END) con ejemplos de petición y respuesta para cada uno, consulta la página Referencia Completa para más detalles.