Hoja de ruta de la API
Qué endpoints de la API v1 están disponibles hoy y qué recursos están en desarrollo.
API v1 en beta
Hoy la API pública expone únicamente el recurso Suscriptores (/v1/subscribers). El resto de
recursos está en desarrollo y no se documenta en esta referencia hasta que esté disponible en
producción, para que nadie construya contra contratos que todavía no existen.
Disponible hoy
URL base: https://fluyio.com/api/v1
| Método | Ruta | Descripción |
|---|---|---|
GET | /subscribers | Listar suscriptores con paginación por cursor y filtros. |
GET | /subscribers/:id | Recuperar un suscriptor. |
POST | /subscribers | Crear un suscriptor. |
PATCH | /subscribers/:id | Actualizar un suscriptor. |
DELETE | /subscribers/:id | Eliminar un suscriptor. |
POST | /subscribers/:id/subscribe | Dar de alta en un canal (email, sms, whatsapp). |
POST | /subscribers/:id/unsubscribe | Dar de baja de un canal o de todos. |
Transversal a todos los endpoints:
- Autenticación y permisos obligatorios por clave de API:
Authorization: Bearer fly_live_…. - Límites de peticiones por API key: 150 peticiones cada 10 segundos y 600 cada 60 segundos.
- Versionado por cabecera
Fluyio-Version: 2026-05-15(única versión publicada). - Idempotencia opcional con la cabecera
Idempotency-Keyen escrituras. - Errores con un sobre JSON estable y
request_id.
Las peticiones a rutas que no aparecen en la tabla no forman parte de la API pública: no están disponibles en la v1. No las llames: su contrato y errores se publicarán cuando estén disponibles.
En desarrollo
| Recurso | Qué cubrirá | Estado |
|---|---|---|
| Listas | Listas estáticas y segmentos; alta y baja de miembros. | En desarrollo |
| Eventos | Ingesta de eventos personalizados (Order Placed, Cart Abandoned, etc.). | En desarrollo |
| Campañas | Crear, programar, enviar y consultar estadísticas de campañas. | En desarrollo |
| Flujos | Listar, disparar e inspeccionar automatizaciones. | En desarrollo |
| Plantillas | Crear, editar y renderizar plantillas. | En desarrollo |
| Formularios | Formularios de captación y sus envíos. | En desarrollo |
| Métricas | Métricas agregadas de campañas, flujos e interacción. | En desarrollo |
| Envío de plantillas y mensajes entrantes. El canal existe en el producto en beta; la mensajería no está en la API pública. El consentimiento de WhatsApp sí se gestiona mediante suscriptores. | En desarrollo | |
| Webhooks salientes | Endpoints, catálogo de eventos y firmas HMAC. No hay entrega operativa de eventos; esta especificación es un borrador, no una guía para activar el servicio. Ver la sección Webhooks. | En desarrollo |
| OAuth para apps de terceros | Autorización delegada para integraciones publicadas para otros clientes de Fluyio. | En estudio |
| SDKs oficiales y OpenAPI | Librerías para Node.js, Python y PHP, especificación OpenAPI y colección Postman. Mientras tanto, usa HTTP desde tu lenguaje: ver HTTP y cURL. | En desarrollo |
Las guías que dependen de estos recursos (integración con Shopify, eventos personalizados, disparar flujos, carrito abandonado, WhatsApp, formularios embebidos y migraciones desde Klaviyo o Mailchimp) se publicarán cuando existan los endpoints correspondientes. La única guía disponible hoy es Sincronizar suscriptores.
Cómo seguir los cambios
- Cada recurso nuevo se anuncia en el historial de cambios con la fecha en que entra en producción.
- Si necesitas alguno de estos recursos antes, escríbenos a [email protected] indicando el caso de uso: priorizamos por demanda real.