Leer tus datos

La API de lectura (/api/v1) devuelve la misma verdad que tu panel, en JSON. Pensada para conectar tus propias herramientas o dársela a una IA para que la analice.

🔧 Para tu equipo técnico

La API de lectura te devuelve tus propios datos —clientes, atribución, personas, cohortes y actividad— en JSON estable, versionado bajo /api/v1. Es la misma verdad que ves en el panel, para que puedas conectar tus herramientas o dársela a una IA que la analice.

Antes de empezar

Base: https://track.alloop.ch
Autenticación obligatoria en toda la API de lectura (expone importes y datos de personas). Manda tu token en la cabecera Authorization: Bearer <tu-token>. Pídelo a alloop si no lo tienes.
Solo ves lo tuyo. Tu token está limitado a tus clientes; pedir el client_id de otra cuenta responde 404 (como si no existiera), nunca los datos de un tercero.

Estos endpoints devuelven datos de personas reales (nombre, email, importe). Trátalos como lo que son: información privada de tus clientes. No los expongas en una web pública ni los pegues en un canal compartido.

Endpoints

`GET /api/v1/clients`

Tus clientes (proyectos) con sus KPIs de cabecera. Es el nivel 0: por dónde empezar. La lista ya viene filtrada a lo que tu token puede ver.

curl -H "Authorization: Bearer $ALLOOP_TOKEN" \
  https://track.alloop.ch/api/v1/clients

`GET /api/v1/clients/{client_id}/attribution`

De dónde vienen tus ventas: origen, canal y pieza que trajo cada ingreso. Responde a "¿qué está funcionando?".

Parámetro	En	Tipo	Req.	Por defecto	Qué hace
`client_id`	ruta	texto	sí	—	Tu cliente.
`days`	query	entero	no	`90`	Ventana en días hacia atrás.

curl -H "Authorization: Bearer $ALLOOP_TOKEN" \
  "https://track.alloop.ch/api/v1/clients/tu-cliente/attribution?days=30"

`GET /api/v1/clients/{client_id}/cohorts`

Cohortes de valor: cuánto deja cada grupo de altas a lo largo del tiempo. Para ver si el cliente nuevo mejora o empeora mes a mes.

Parámetro	En	Tipo	Req.	Qué hace
`client_id`	ruta	texto	sí	Tu cliente.

`GET /api/v1/clients/{client_id}/people`

Las personas (tus clientes finales) con su origen. Es el nivel 1: de los KPIs a los nombres.

Parámetro	En	Tipo	Req.	Por defecto	Qué hace
`client_id`	ruta	texto	sí	—	Tu cliente.
`limit`	query	entero	no	`50`	Cuántas personas devolver.

`GET /api/v1/clients/{client_id}/people/{person_id}/timeline`

El recorrido completo de una persona, en lenguaje llano y con el detalle debajo. Es el nivel 2: qué hizo esta persona concreta desde que llegó.

Parámetro	En	Tipo	Req.	Qué hace
`client_id`	ruta	texto	sí	Tu cliente.
`person_id`	ruta	texto	sí	La persona dentro de ese cliente.

`GET /api/v1/clients/{client_id}/campus`

Actividad del campus: KPIs, la serie diaria y qué alumnos están en riesgo. Solo aplica si usas el módulo de campus.

Parámetro	En	Tipo	Req.	Qué hace
`client_id`	ruta	texto	sí	Tu cliente.

Dárselo a una IA

Como la respuesta es JSON estable, puedes pegar el resultado de cualquiera de estos endpoints en Claude, ChatGPT o Gemini y pedirle que te lo analice ("¿qué canal me trae los clientes que más duran?"). No sustituye a tu panel, pero acelera las preguntas sueltas.

Pregúntale a tu IA

Esta documentación está pensada para leerse con una IA al lado. Abre tu asistente con el contexto de alloop ya cargado y pregúntale lo que necesites, en tu idioma.

Para qué NO sirve: una IA no ve tu panel, tus pagos ni tus datos, y puede equivocarse. Si un ingreso no aparece, algo toca tu producción o necesitas una respuesta oficial, escríbenos: esto no sustituye al soporte.

Claude ChatGPT Gemini

On this page