Automatiser la création de flipbooks avec l'API FlipLink

Si tu publies tes flipbooks un par un depuis le tableau de bord, tu laisses de l'efficacité sur la table. L'API FlipLink te permet d'automatiser chaque étape du processus de création de flipbooks — du téléversement des PDF à la configuration des réglages en passant par la publication — le tout sans toucher à l'interface. Que tu construises une plateforme de publication, que tu l'intègres à un CMS ou que tu génères des rapports automatisés, ce guide te montre tout ce dont tu as besoin pour démarrer.

Pourquoi automatiser la création de flipbooks ?

La création manuelle de flipbooks fonctionne très bien quand tu gères quelques documents par semaine. Mais que se passe-t-il quand tu dois traiter des dizaines ou des centaines de PDF de façon régulière ? C'est là que l'API FlipLink devient essentielle. Chaque point de terminaison, paramètre et réponse de ce guide est documenté dans la référence de l'API en ligne, où tu peux aussi tester les appels directement dans ton navigateur.

L'automatisation débloque plusieurs avantages :

• La vitesse à grande échelle — Convertis des centaines de PDF en flipbooks en quelques minutes au lieu de plusieurs heures
• La cohérence — Chaque flipbook suit le même branding, les mêmes réglages et la même configuration
• Moins d'erreurs humaines — Aucune étape oubliée ni réglage manquant quand un script gère le processus
• L'intégration au flux de travail — Déclenche la création de flipbooks depuis tes outils et pipelines existants
• La publication à la demande — Génère et distribue des flipbooks dès qu'un nouveau contenu est prêt

Bien démarrer avec l'API FlipLink

Authentification

Chaque requête API nécessite une clé API pour l'authentification. Tu peux générer ta clé depuis le tableau de bord FlipLink sous Réglages > Accès API. Inclus la clé dans l'en-tête X-Api-Key de chaque requête :

X-Api-Key: YOUR_API_KEY

Garde ta clé API en sécurité. Stocke-la dans des variables d'environnement ou un gestionnaire de secrets — ne la code jamais en dur dans du code côté client et ne la commite jamais dans le contrôle de version. Consulte la section Authentification de la référence de l'API pour tous les détails.

URL de base et limites de débit

Tous les points de terminaison de l'API sont servis depuis l'URL de base https://go.fliplink.me/api. Les limites de débit s'appliquent par clé API (300 requêtes/minute), donc si tu exécutes des opérations par lots, intègre de petits délais entre les requêtes pour rester sous le seuil autorisé. Les échecs d'authentification renvoient un code HTTP 401 ; dans tous les autres cas, l'API répond avec un code HTTP 200 et un corps JSON dont le champ Result vaut "OK" ou "ERROR" — alors branche-toi toujours sur Result, pas seulement sur le code d'état. Parcours la liste complète des points de terminaison, avec des exemples en direct, dans la référence de l'API.

Téléverser des PDF par programmation

Le cœur de la création automatisée de flipbooks est le point de terminaison Create by File, POST /api/create-by-file. Tu envoies le PDF sous forme de téléversement de formulaire multipart et FlipLink le transforme en flipbook. Si ton PDF se trouve déjà à une URL publique, utilise plutôt POST /api/create-by-url et passe FileURL au lieu de File.

Une requête de téléversement typique comprend :

• Le fichier PDF (File, données binaires via formulaire multipart)
• Un Name (interne) et un Title (affiché) pour le flipbook
• Le DocType (par exemple 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'

Un appel réussi renvoie {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} avec ton quota de publications restant (Flipbooks_Left). Récupère l'ID — tu l'utiliseras comme paramètre de chemin {flipbookId} dans tous les appels de configuration ci-dessous.

Configurer les réglages du flipbook via l'API

Téléverser un PDF n'est que la première étape. L'API te permet aussi de configurer chaque réglage que tu ajusterais normalement dans le tableau de bord. Plutôt qu'un seul appel de mise à jour fourre-tout, FlipLink expose un point de terminaison set-* ciblé par groupe de réglages — chacun est un PUT au format form-urlencoded qui prend l'ID du flipbook comme paramètre de chemin (/api/set-…/{flipbookId}). Ça garde chaque appel petit et prévisible dans un pipeline par lots.

Options de configuration courantes

• Accès par mot de passe — set-password-access pour protéger un flipbook derrière un mot de passe
• Branding — set-logo, set-background-image, set-skin, set-meta pour les métadonnées SEO et l'image sociale
• Capture de prospects — set-lead-capture (avec set-lead-fields, set-lead-webhook, set-lead-google-sheets) pour collecter les informations du lecteur
• Domaine personnalisé — publie sous ton propre domaine via les points de terminaison CNAME (voir la configuration CNAME)
• État de publication — set-published pour publier ou dépublier à la demande
• Partage et contrôles du lecteur — set-share-channels, set-viewer-controls, et plus encore

# 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'

Chaque appel de réglage renvoie {"Result":"OK","Message":"Updated successfully"}. Cette séparation entre téléversement et configuration permet d'appliquer facilement des réglages différents à des flipbooks différents au sein d'un même flux de travail par lots. La référence de l'API liste chaque point de terminaison set-* avec ses paramètres exacts et une console Try-It en direct.

Flux de travail de création par lots

Quand tu dois convertir un dossier entier de PDF, un flux de travail par lots se charge du gros du travail. Le schéma est simple :

1. Analyse ton répertoire source à la recherche de fichiers PDF
2. Téléverse chaque PDF vers l'API FlipLink
3. Configure les réglages selon des règles (par exemple, des motifs de noms de fichiers, des fichiers de métadonnées)
4. Enregistre les URL des flipbooks obtenus
5. Notifie les parties prenantes ou les systèmes en aval

Voici un exemple Python simplifié :

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")

Note la gestion de la réponse : FlipLink renvoie un code HTTP 200 même pour les erreurs applicatives, donc le script se branche sur le champ JSON Result plutôt que sur le code d'état. Pour les lots plus importants, ajoute des tentatives de reprise pour les téléversements échoués et respecte la limite de débit (300/min) en insérant une courte pause entre les requêtes.

Rappels par webhook pour des mises à jour en temps réel

Une fois qu'un flipbook est en ligne, les webhooks te permettent de réagir à l'activité des lecteurs en temps réel au lieu de faire du polling. Tu configures un webhook par flipbook avec PUT /api/set-lead-webhook/{flipbookId}, en le pointant vers ton propre point de terminaison. FlipLink envoie alors un POST à cette URL quand le flipbook capture une activité — principalement de nouveaux prospects, les événements de vues et de ventes étant disponibles via les réglages de prospects et de ventes associés.

Pour câbler ça par programmation :

# 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'

Tu peux déclencher un envoi de test à tout moment avec POST /api/test-webhook/{flipbookId} pour confirmer que ton gestionnaire reçoit bien la charge utile avant la mise en production. Les webhooks permettent des pipelines en temps réel : quand un nouveau prospect arrive, ton gestionnaire pourrait pousser le contact dans un CRM, envoyer une notification Slack ou déclencher une campagne d'e-mails. Tu préfères le no-code ? Les mêmes événements peuvent passer par Zapier, Make ou n8n. Consulte le groupe de points de terminaison Lead Capture dans la référence de l'API pour les options de webhook et Google Sheets.

Cas d'usage concrets

Plateformes de publication

Les sociétés de médias et les plateformes de contenu peuvent intégrer FlipLink à leur pipeline de publication. Quand un éditeur finalise un numéro de magazine ou une newsletter, le système convertit automatiquement l'export PDF en flipbook et l'intègre sur le site — aucune étape manuelle requise.

Intégrations CMS

Connecte FlipLink à ton système de gestion de contenu pour que téléverser un PDF dans un dossier ou un type de contenu spécifique déclenche la création automatique d'un flipbook. Le code d'intégration obtenu s'insère dans la page ou l'article concerné. C'est particulièrement puissant pour les catalogues de produits, les lookbooks et les sites de documentation.

Distribution automatisée de rapports

Les rapports financiers, les bilans trimestriels et les documents de conformité suivent souvent un calendrier prévisible. Automatise tout le flux : génère le PDF depuis ton outil de reporting, téléverse-le vers FlipLink via l'API, applique le bon branding et les contrôles d'accès, et distribue le lien du flipbook aux parties prenantes — le tout déclenché par une seule tâche cron ou un événement de flux de travail.

Catalogues de produits e-commerce

Les détaillants dont les catalogues sont fréquemment mis à jour peuvent régénérer des flipbooks dès que les données produits changent. Récupère le dernier PDF de catalogue depuis ton système de gestion d'informations produits, crée un nouveau flipbook et remplace l'intégration sur ta boutique — pour garder tes clients devant un inventaire à jour sans intervention manuelle.

Combiner l'accès API avec les intégrations d'automatisation

L'API est puissante en soi, mais elle devient encore plus polyvalente associée aux intégrations d'automatisation. Utilise des outils comme Zapier, Make ou n8n pour connecter FlipLink à des centaines d'autres applications sans écrire de code. Par exemple :

• Google Drive + FlipLink — Crée automatiquement un flipbook quand un nouveau PDF apparaît dans un dossier Drive spécifique
• Shopify + FlipLink — Génère un flipbook produit dès qu'une nouvelle collection est publiée
• HubSpot + FlipLink — Attache un lien de flipbook à une fiche contact quand cette personne demande une brochure

Pour un examen plus approfondi de la connexion de FlipLink avec des outils tiers, consulte notre guide sur l'utilisation de l'API FlipLink pour les intégrations.

Bonnes pratiques pour les flux de travail de flipbooks pilotés par API

• Utilise des opérations idempotentes — Inclus un identifiant de référence unique avec chaque téléversement pour pouvoir réessayer en toute sécurité sans créer de doublons
• Gère les erreurs avec élégance — Journalise les échecs, mets en place des tentatives de reprise avec un backoff exponentiel et alerte en cas d'erreurs répétées
• Stocke les identifiants de flipbook — Associe chaque PDF source à son ID dans ta base de données ; c'est le paramètre de chemin {flipbookId} de chaque appel de lecture, mise à jour et suppression
• Branche-toi sur Result, pas sur le code d'état — Les erreurs applicatives reviennent en HTTP 200 avec Result: "ERROR" ; seuls les échecs d'authentification utilisent 401
• Surveille ton usage — Suis ton volume d'appels API par rapport à la limite de débit de 300/min, et surveille Flipbooks_Left dans les réponses de création par rapport à ta capacité de publications actives

Commence à automatiser dès aujourd'hui

L'API FlipLink transforme la création de flipbooks d'une tâche manuelle en un flux de travail automatisé et évolutif. Que tu traites dix PDF par semaine ou dix mille, l'API s'en charge avec une qualité constante et zéro effort manuel.

Prêt à construire ton pipeline de flipbooks automatisé ? Crée ton compte FlipLink, récupère ta clé et ouvre la référence de l'API pour tester les points de terminaison en direct dans ton navigateur. Consulte notre page tarifs pour découvrir l'offre à vie unique à partir de $39.