Cómo usar la API de FlipLink para integraciones

Si gestionas decenas (o cientos) de flipbooks, hacer todo manualmente desde el panel de control se vuelve tedioso rápido. Ahí es donde entra la API de FlipLink — te permite crear flipbooks de forma programática, administrar publicaciones, extraer analíticas e integrar FlipLink con tus herramientas y flujos de trabajo existentes.

Ya seas un desarrollador construyendo una integración personalizada o un líder de equipo buscando automatizar tareas repetitivas, esta guía te muestra qué puede hacer la API y cómo empezar.

Qué te permite hacer la API de FlipLink

La API REST de FlipLink te da acceso programático a las mismas capacidades disponibles en el panel de control. En lugar de hacer clic por la interfaz, envías solicitudes HTTP y recibes respuestas JSON estructuradas.

Esto es lo que puedes lograr:

• Crear flipbooks y documentos a partir de archivos PDF (carga o URL) sin abrir el panel de control
• Actualizar configuraciones de publicación como metadatos, formularios de captura de leads, skins y controles de acceso
• Extraer datos de engagement — conteos de vistas por flipbook, además de exportaciones completas de leads y ventas
• Gestionar publicaciones a escala — crea, actualiza o elimina decenas de flipbooks en un solo script
• Disparar flujos de trabajo con webhooks por flipbook que se activan cuando se captura un nuevo lead

Para una descripción completa de las funciones programáticas, consulta la página de la función API Access — y para los endpoints exactos, los parámetros y ejemplos en vivo, la referencia de la API.

Cómo obtener tu API key

Antes de hacer cualquier llamada a la API, necesitas una API key. Así la obtienes:

1. Inicia sesión en tu panel de FlipLink en go.fliplink.me
2. Ve a Settings → API Access
3. Haz clic en Generate API Key
4. Copia la clave y guárdala de forma segura — trátala como una contraseña

Tu API key autentica cada solicitud. Inclúyela en el encabezado X-Api-Key:

X-Api-Key: YOUR_API_KEY

Importante: Nunca expongas tu API key en código del lado del cliente ni en repositorios públicos. Mantenla en el servidor o en variables de entorno. La sección de Autenticación de la referencia de la API cubre esto en detalle.

Casos de uso comunes de la API

Creación masiva de flipbooks

¿Tienes una carpeta con 50 catálogos de productos que necesitan convertirse en flipbooks? En lugar de subirlos uno por uno, escribe un script que recorra tus PDFs y llame al endpoint de creación para cada uno. Combínalo con Bulk Operations para máxima eficiencia.

Incorporar analíticas en tu propio panel

Si haces seguimiento del rendimiento de marketing en una herramienta centralizada — un panel personalizado, Google Sheets o una plataforma de BI — puedes extraer datos de vistas y engagement de FlipLink vía la API y consolidarlos junto con tus otras métricas.

Gestión de publicaciones a escala

¿Necesitas actualizar el branding en todos tus flipbooks después de un cambio de imagen? ¿O archivar los catálogos del trimestre pasado? La API te permite hacer esas actualizaciones en lote sin hacer clic en cada publicación individualmente.

Conexión con plataformas de automatización

Combina la API con herramientas como Zapier, Pabbly o Make para construir flujos de trabajo sin código. Por ejemplo, crear automáticamente un flipbook cada vez que un nuevo PDF llega a una carpeta específica de Google Drive. Consulta nuestra guía sobre cómo conectar FlipLink con plataformas de automatización para instrucciones paso a paso, o explora la función de Automation and Integrations.

🚀

Prueba FlipLink Gratis

Convierte tu PDF en segundos. Sin registro, sin tarjeta de crédito — solo súbelo y listo.

Drop your PDF here or click to browse

Máximo 40MB

Los planes de pago desde $39 lo amplían a 150 MB.

Ejemplo: crear un flipbook vía API

Aquí tienes un ejemplo básico usando curl para crear un nuevo flipbook a partir de una carga de PDF:

curl -X POST 'https://go.fliplink.me/api/create-by-file' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@product-catalog.pdf' \
  -F 'Name=Spring Product Catalog' \
  -F 'Title=Spring Product Catalog' \
  -F 'DocType=Flipbook'

La API devuelve una respuesta JSON — {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} — con el ID de la publicación y la URL para compartir que necesitas para distribuir el flipbook de inmediato. ¿Ya tienes el PDF en línea? Cambia a POST /api/create-by-url y pasa FileURL en lugar de File.

Puedes hacer lo mismo en Python, Node.js o cualquier lenguaje que soporte HTTP. La API es REST estándar con cuerpos form-urlencoded (o multipart), así que funciona con cualquier stack que ya estés usando. Algo que recordar: los errores de aplicación vuelven como HTTP 200 con Result: "ERROR" (solo los fallos de autenticación devuelven 401), así que ramifica según el campo Result.

Endpoints disponibles de la API

Esto es solo una pequeña parte — el catálogo completo de más de 80 endpoints, cada uno con sus parámetros y una consola Try-It en vivo, está en la referencia de la API.

Todos los endpoints devuelven JSON. El límite de tasa es de 300 solicitudes por minuto por clave API. Consulta la referencia de la API para cada endpoint, sus parámetros, el modelo de errores y las rutas de dependencia.

Cuándo usar la API vs. el panel de control

No todo necesita una llamada a la API. Aquí tienes un marco de decisión simple:

• Usa el panel cuando estés creando un solo flipbook, ajustando configuraciones de diseño visualmente o explorando analíticas de forma casual
• Usa la API cuando manejes más de cinco publicaciones a la vez, integres con otros sistemas o automatices tareas recurrentes
• Usa plataformas de automatización (Zapier/Make/Pabbly) cuando quieras el poder de la API sin escribir código

Para equipos que gestionan catálogos de productos o cualquier contenido que se actualice regularmente, la API se paga sola en tiempo ahorrado después de la primera ejecución masiva.

Empieza a construir

La API de FlipLink convierte el trabajo manual repetitivo en flujos automatizados. Ya sea que sincronices analíticas con un panel, crees flipbooks masivamente desde un pipeline de contenido o conectes FlipLink a tu CRM — la API te da el control para construir exactamente lo que necesitas.

¿Listo para empezar? Crea tu cuenta gratuita de FlipLink, genera tu API key y abre la referencia de la API para probar cada endpoint en vivo en tu navegador. Consulta nuestros precios para ver qué incluye el acceso a la API.