Automatiza flipbooks con la API de FlipLink

Si publicas flipbooks uno por uno a través del panel, estás dejando eficiencia sobre la mesa. La API de FlipLink te permite automatizar cada paso del proceso de creación de flipbooks — desde subir PDFs hasta configurar ajustes y publicar — todo sin tocar la interfaz. Ya sea que estés construyendo una plataforma de publicación, integrando con un CMS o generando informes automatizados, esta guía te lleva por todo lo que necesitas para empezar.

¿Por qué automatizar la creación de flipbooks?

La creación manual de flipbooks funciona bien cuando manejas unos pocos documentos por semana. Pero ¿qué pasa cuando necesitas procesar docenas o cientos de PDFs de forma regular? Ahí es donde la API de FlipLink se vuelve esencial. Cada endpoint, parámetro y respuesta de esta guía está documentado en la referencia de la API en vivo, donde además puedes probar las llamadas directamente en el navegador.

La automatización desbloquea varias ventajas:

• Velocidad a escala — Convierte cientos de PDFs en flipbooks en minutos en lugar de horas
• Consistencia — Cada flipbook sigue el mismo branding, ajustes y configuración
• Menos errores humanos — Sin pasos omitidos ni ajustes olvidados cuando un script maneja el proceso
• Integración con flujos de trabajo — Dispara la creación de flipbooks desde tus herramientas y pipelines existentes
• Publicación bajo demanda — Genera y distribuye flipbooks en el momento en que el nuevo contenido está listo

Primeros pasos con la API de FlipLink

Autenticación

Cada solicitud a la API requiere una clave API para autenticación. Puedes generar tu clave desde el panel de FlipLink en Configuración > Acceso API. Incluye la clave en el encabezado X-Api-Key de cada solicitud:

X-Api-Key: YOUR_API_KEY

Mantén tu clave API segura. Almacénala en variables de entorno o un gestor de secretos — nunca la codifiques directamente en el código del lado del cliente ni la subas al control de versiones. Consulta la sección de Autenticación de la referencia de la API para todos los detalles.

URL base y límites de tasa

Todos los endpoints de la API se sirven bajo la URL base https://go.fliplink.me/api. Los límites de tasa aplican por clave API (300 solicitudes/minuto), así que si ejecutas operaciones por lotes, incluye pequeñas pausas entre solicitudes para mantenerte dentro del umbral permitido. Los fallos de autenticación devuelven HTTP 401; en cualquier otro caso la API responde con HTTP 200 y un cuerpo JSON cuyo campo Result es "OK" o "ERROR" — así que ramifica siempre según Result, no solo según el código de estado. Explora la lista completa de endpoints, con ejemplos en vivo, en la referencia de la API.

Subir PDFs programáticamente

El núcleo de la creación automatizada de flipbooks es el endpoint Create by File, POST /api/create-by-file. Envías el PDF como carga multipart y FlipLink lo procesa como flipbook. Si tu PDF ya está alojado en una URL pública, usa POST /api/create-by-url en su lugar y pasa FileURL en lugar de File.

Una solicitud típica de carga incluye:

• El archivo PDF (File, datos binarios vía formulario multipart)
• Un Name (interno) y un Title (visible) para el flipbook
• El DocType (por ejemplo, Flipbook)

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

Una llamada exitosa devuelve {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} con tu cuota de publicación restante (Flipbooks_Left). Captura el ID — lo usarás como parámetro de ruta {flipbookId} en cada llamada de configuración que aparece más abajo.

Configurar ajustes del flipbook vía API

Subir un PDF es solo el primer paso. La API también te permite configurar cada ajuste que normalmente ajustarías en el panel. En lugar de una única llamada de actualización para todo, FlipLink expone un endpoint set-* específico por grupo de ajustes — cada uno es un PUT con form-urlencoded que toma el ID del flipbook como parámetro de ruta (/api/set-…/{flipbookId}). Eso mantiene cada llamada pequeña y predecible en un pipeline por lotes.

Opciones de configuración comunes

• Acceso con contraseña — set-password-access para proteger un flipbook detrás de una contraseña
• Branding — set-logo, set-background-image, set-skin, set-meta para metadatos SEO e imagen social
• Captura de leads — set-lead-capture (más set-lead-fields, set-lead-webhook, set-lead-google-sheets) para recopilar información del visitante
• Dominio personalizado — publica bajo tu propio dominio vía los endpoints CNAME (consulta la configuración CNAME)
• Estado de publicación — set-published para publicar o despublicar bajo demanda
• Controles de compartición y visor — set-share-channels, set-viewer-controls y más

# Example: password-protect the flipbook you just created
curl -X PUT 'https://go.fliplink.me/api/set-password-access/90001' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsPasswordProtected=true' \
  --data-urlencode 'Password=spring2026'

Cada llamada de ajuste devuelve {"Result":"OK","Message":"Updated successfully"}. Esta separación entre carga y configuración facilita aplicar diferentes ajustes a diferentes flipbooks dentro del mismo flujo de trabajo por lotes. La referencia de la API lista cada endpoint set-* con sus parámetros exactos y una consola Try-It en vivo.

Flujos de trabajo de creación por lotes

Cuando necesitas convertir toda una carpeta de PDFs, un flujo por lotes hace el trabajo pesado. El patrón es sencillo:

1. Escanea tu directorio de origen en busca de archivos PDF
2. Sube cada PDF a la API de FlipLink
3. Configura los ajustes basándote en reglas (por ejemplo, patrones de nombre de archivo, archivos de metadatos)
4. Registra las URLs de flipbook resultantes
5. Notifica a los involucrados o sistemas posteriores

Aquí tienes un ejemplo simplificado en Python:

import os
import requests

API_KEY = os.environ["FLIPLINK_API_KEY"]
PDF_DIR = "./catalogs"
BASE = "https://go.fliplink.me/api"
HEADERS = {"X-Api-Key": API_KEY}

results = []

for filename in os.listdir(PDF_DIR):
    if not filename.endswith(".pdf"):
        continue

    filepath = os.path.join(PDF_DIR, filename)
    title = filename.replace(".pdf", "").replace("-", " ").title()

    with open(filepath, "rb") as f:
        response = requests.post(
            f"{BASE}/create-by-file",
            headers=HEADERS,
            files={"File": (filename, f, "application/pdf")},
            data={"Name": title, "Title": title, "DocType": "Flipbook"},
        )

    data = response.json()
    if data.get("Result") == "OK":
        results.append({"title": title, "id": data["ID"], "url": data["URL"]})
        print(f"Created: {title} -> {data['URL']}")
    else:
        print(f"Failed: {title} -> {data.get('Message')}")

print(f"Batch complete: {len(results)} flipbooks created")

Fíjate en el manejo de la respuesta: FlipLink devuelve HTTP 200 incluso ante errores de aplicación, así que el script ramifica según el campo JSON Result en lugar del código de estado. Para lotes más grandes, agrega reintentos para las cargas fallidas y respeta el límite de tasa (300/min) insertando una pausa breve entre solicitudes.

Callbacks webhook para actualizaciones en tiempo real

Una vez que un flipbook está en vivo, los webhooks te permiten reaccionar a la actividad del visitante en tiempo real en lugar de consultar repetidamente. Configuras un webhook por flipbook con PUT /api/set-lead-webhook/{flipbookId}, apuntándolo a tu propio endpoint. FlipLink entonces envía un POST a esa URL cuando el flipbook captura actividad — principalmente nuevos leads, con eventos de visualización y venta disponibles a través de los ajustes relacionados de leads y ventas.

Para configurarlo programáticamente:

# Send new-lead events for flipbook 90001 to your endpoint
curl -X PUT 'https://go.fliplink.me/api/set-lead-webhook/90001' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'WebhookURL_NewLead=https://example.com/hooks/fliplink'

Puedes lanzar una entrega de prueba en cualquier momento con POST /api/test-webhook/{flipbookId} para confirmar que tu handler recibe la carga antes de salir en vivo. Los webhooks habilitan pipelines en tiempo real: cuando llega un nuevo lead, tu handler podría insertar el contacto en un CRM, enviar una notificación de Slack o disparar una campaña de email. ¿Prefieres no-code? Los mismos eventos pueden enrutarse a través de Zapier, Make o n8n. Consulta el grupo de endpoints de Captura de Leads en la referencia de la API para las opciones de webhook y Google Sheets.

Casos de uso del mundo real

Plataformas de publicación

Empresas de medios y plataformas de contenido pueden integrar FlipLink en su pipeline de publicación. Cuando un editor finaliza un número de revista o newsletter, el sistema convierte automáticamente la exportación PDF en un flipbook y lo incrusta en el sitio web — sin pasos manuales.

Integraciones con CMS

Conecta FlipLink a tu sistema de gestión de contenidos para que subir un PDF a una carpeta o tipo de contenido específico dispare la creación automática de flipbooks. El código de incrustación resultante se inserta en la página o publicación correspondiente. Esto es especialmente poderoso para catálogos de productos, lookbooks y sitios de documentación.

Distribución automatizada de informes

Informes financieros, revisiones trimestrales y documentos de compliance a menudo siguen un calendario predecible. Automatiza todo el flujo: genera el PDF desde tu herramienta de reportes, súbelo a FlipLink vía API, aplica el branding y controles de acceso correctos, y distribuye el enlace del flipbook a los involucrados — todo disparado por un solo cron job o evento de flujo de trabajo.

Catálogos de productos e-commerce

Los retailers con catálogos que se actualizan frecuentemente pueden regenerar flipbooks cada vez que cambian los datos de productos. Obtén el último PDF del catálogo de tu sistema de gestión de información de productos, crea un nuevo flipbook y reemplaza la incrustación en tu tienda — manteniendo a los clientes viendo inventario actualizado sin intervención manual.

Combinando acceso API con integraciones de automatización

La API es poderosa por sí sola, pero se vuelve aún más versátil cuando se combina con integraciones de automatización. Usa herramientas como Zapier, Make o n8n para conectar FlipLink a cientos de otras apps sin escribir código. Por ejemplo:

• Google Drive + FlipLink — Crea automáticamente un flipbook cuando aparece un nuevo PDF en una carpeta específica de Drive
• Shopify + FlipLink — Genera un flipbook de productos cada vez que se publica una nueva colección
• HubSpot + FlipLink — Adjunta un enlace de flipbook al registro de un contacto cuando solicita un folleto

Para profundizar en la conexión de FlipLink con herramientas de terceros, consulta nuestra guía sobre cómo usar la API de FlipLink para integraciones.

Buenas prácticas para flujos de trabajo de flipbooks basados en API

• Usa operaciones idempotentes — Incluye un ID de referencia único con cada carga para poder reintentar sin crear duplicados
• Maneja errores con elegancia — Registra fallos, implementa reintentos con retroceso exponencial y alerta ante errores repetidos
• Almacena los IDs de flipbook — Mapea cada PDF de origen a su ID en tu base de datos; es el parámetro de ruta {flipbookId} para cada llamada de lectura, actualización y eliminación
• Ramifica según Result, no según el estado — Los errores de aplicación vuelven como HTTP 200 con Result: "ERROR"; solo los fallos de autenticación usan 401
• Monitorea el uso — Rastrea tu volumen de llamadas API contra el límite de tasa de 300/min, y vigila Flipbooks_Left en las respuestas de creación contra tu capacidad de publicaciones activas

Empieza a automatizar hoy

La API de FlipLink transforma la creación de flipbooks de una tarea manual en un flujo de trabajo escalable y automatizado. Ya sea que proceses diez PDFs a la semana o diez mil, la API lo maneja con calidad consistente y cero esfuerzo manual.

¿Listo para construir tu pipeline automatizado de flipbooks? Crea tu cuenta de FlipLink, obtén tu clave y abre la referencia de la API para probar los endpoints en vivo en tu navegador. Consulta nuestra página de precios para ver la oferta única de por vida desde $39.