Referencia de API

El mapa completo de la API de alloop-tracking: los 56 endpoints que tú o tu equipo técnico podéis usar. Todo lo interno (administración, panel) queda fuera a propósito.

🔧 Para tu equipo técnico

Esta es la superficie de la API que puedes tocar como cliente: leer tus datos, integrar el snippet y conectar tus pagos. Son 55 rutas (56 operaciones). Las operaciones internas de administración y el panel no forman parte de esta referencia.

En dos minutos

Base: https://track.alloop.ch
Autenticación: las rutas de lectura (/api/v1/*) y las privadas piden tu token en Authorization: Bearer <token>. Los endpoints del snippet (/config, /checkout, /event, /form) son públicos por diseño.
Solo ves lo tuyo: tu token está limitado a tu cuenta; pedir datos de otra responde 404.
Empieza por: Leer tus datos si quieres consultar; Integrar el snippet si quieres medir tu web.

Todos los endpoints

Lectura de datos

Tus datos en JSON. Requiere token. → Ver detalle

Método	Ruta
`GET`	`/api/v1/clients`
`GET`	`/api/v1/clients/{client_id}/attribution`
`GET`	`/api/v1/clients/{client_id}/campus`
`GET`	`/api/v1/clients/{client_id}/cohorts`
`GET`	`/api/v1/clients/{client_id}/people`
`GET`	`/api/v1/clients/{client_id}/people/{person_id}/timeline`

Snippet / ingesta

Lo dispara el snippet por ti. → Ver detalle

Método	Ruta
`POST`	`/activity`
`POST`	`/bot-step`
`POST`	`/event`
`POST`	`/form`
`POST`	`/stitch`
`POST`	`/video-milestone`

Pagos (Stripe)

Checkout y webhooks del cobro.

Método	Ruta
`GET`	`/access-email`
`POST`	`/access-email`
`POST`	`/checkout`
`GET`	`/purchase-info`
`POST`	`/upsell`
`POST`	`/upsell/decline`
`POST`	`/webhooks/stripe`
`POST`	`/webhooks/stripe/{client_id}`

Pagos (WooCommerce)

Webhook de pedidos de WooCommerce.

Método	Ruta
`POST`	`/webhooks/woo/{client_id}`

Membresía

Cancelación, pausa y portal — los llama tu plugin.

Método	Ruta
`POST`	`/membership/cancel/apply`
`POST`	`/membership/cancel/confirm`
`POST`	`/membership/cancel/offers`
`POST`	`/membership/portal/session`
`POST`	`/membership/subscription/pause`
`POST`	`/membership/subscription/resume`
`POST`	`/membership/subscription/status`

Recuperación de pago

Página para recuperar un pago que falló.

Método	Ruta
`GET`	`/recuperar`
`POST`	`/recuperar/lookup`
`POST`	`/recuperar/prepare`

Tutor IA (Companion)

El tutor IA del alumno; lo usa el producto, no se llama a mano.

Método	Ruta
`POST`	`/me/companion/chat`
`POST`	`/me/companion/correction`
`POST`	`/me/companion/home`
`POST`	`/me/companion/prompts`
`POST`	`/me/companion/prompts/set`
`POST`	`/me/companion/settings`
`POST`	`/me/companion/settings/set`
`POST`	`/me/companion/voice`
`POST`	`/me/companion/voice/close`
`POST`	`/me/companion/voice/compact`
`POST`	`/me/companion/voice/reply`
`POST`	`/me/companion/voice/reply/stream`
`POST`	`/me/companion/voice/speak`
`POST`	`/me/companion/voice/summary`
`POST`	`/me/companion/voice/turn`

Chat en vivo

Chat en directo embebido en tu comunidad.

Método	Ruta
`POST`	`/chat/{client_id}/{room}/host/clear`
`POST`	`/chat/{client_id}/{room}/host/send`
`POST`	`/chat/{client_id}/{room}/send`
`GET`	`/chat/{client_id}/{room}/stream`
`GET`	`/chat/{client_id}/{room}/whois`
`POST`	`/chat/{client_id}/{room}/youtube/connect`
`POST`	`/chat/{client_id}/{room}/youtube/disconnect`
`GET`	`/chat/{client_id}/{room}/youtube/status`

General

Config y estado, públicos. → Ver detalle

Método	Ruta
`GET`	`/api/health`
`GET`	`/config/{client_id}`

Este índice se genera desde el esquema real del servicio, así que está siempre al día. La app desactiva su /openapi.json en producción a propósito (no exponer el mapa de rutas sin autenticar); el esquema publicado aquí es solo la parte tenant-facing.

On this page