Come Usare l'API di FlipLink per Integrazioni Personalizzate

Se gestisci decine (o centinaia) di flipbook, fare tutto manualmente dalla dashboard diventa noioso in fretta. È qui che entra in gioco l'API di FlipLink — ti permette di creare flipbook in modo programmatico, gestire le pubblicazioni, ottenere dati analitici e collegare FlipLink ai tuoi strumenti e workflow esistenti.

Che tu sia uno sviluppatore che crea un'integrazione personalizzata o un team leader che vuole automatizzare attività ripetitive, questa guida ti mostra cosa può fare l'API e come iniziare.

Cosa Ti Permette di Fare l'API di FlipLink

L'API REST di FlipLink ti dà accesso programmatico alle stesse funzionalità disponibili nella dashboard. Invece di cliccare nell'interfaccia, invii richieste HTTP e ricevi risposte JSON strutturate.

Ecco cosa puoi realizzare:

• Creare flipbook e documenti da file PDF (upload o URL) senza aprire la dashboard
• Aggiornare le impostazioni di pubblicazione come metadati, moduli di lead capture, skin e controlli di accesso
• Estrarre dati di coinvolgimento — conteggi di visualizzazioni per flipbook, più export completi di lead e vendite
• Gestire le pubblicazioni su larga scala — creare, aggiornare o eliminare decine di flipbook con un singolo script
• Attivare workflow con webhook per flipbook che si attivano quando viene acquisito un nuovo lead

Per una panoramica completa delle funzionalità programmatiche, consulta la pagina della funzione API Access — e per gli endpoint esatti, i parametri e gli esempi live, il riferimento API.

Ottenere la Tua API Key

Prima di effettuare qualsiasi chiamata API, hai bisogno di un'API key. Ecco come ottenerla:

1. Accedi alla tua dashboard FlipLink su go.fliplink.me
2. Vai su Impostazioni → API Access
3. Clicca su Genera API Key
4. Copia la chiave e conservala in modo sicuro — trattala come una password

La tua API key autentica ogni richiesta. Includila nell'header X-Api-Key:

X-Api-Key: YOUR_API_KEY

Importante: Non esporre mai la tua API key nel codice lato client o in repository pubblici. Mantienila lato server o nelle variabili d'ambiente. La sezione Autenticazione del riferimento API copre questo aspetto in dettaglio.

Casi d'Uso Comuni dell'API

Creazione di Flipbook in Blocco

Hai una cartella con 50 cataloghi prodotti da trasformare in flipbook? Invece di caricarli uno per uno, scrivi uno script che itera sui tuoi PDF e chiama l'endpoint di creazione per ciascuno. Abbina questa funzione alle Operazioni in blocco per la massima efficienza.

Integrare i Dati Analitici nella Tua Dashboard

Se monitori le performance di marketing in uno strumento centralizzato — una dashboard personalizzata, Google Sheets o una piattaforma BI — puoi estrarre i dati di visualizzazione e coinvolgimento di FlipLink tramite API e consolidarli insieme alle altre metriche.

Gestione delle Pubblicazioni su Larga Scala

Devi aggiornare il branding di tutti i tuoi flipbook dopo un rebranding? O archiviare i cataloghi del trimestre scorso? L'API ti permette di eseguire questi aggiornamenti in blocco senza cliccare su ogni pubblicazione singolarmente.

Collegamento a Piattaforme di Automazione

Combina l'API con strumenti come Zapier, Pabbly o Make per creare workflow no-code. Ad esempio, crea automaticamente un flipbook ogni volta che un nuovo PDF arriva in una cartella specifica di Google Drive. Consulta la nostra guida su come collegare FlipLink a Zapier, Pabbly e Make per istruzioni passo-passo, oppure esplora la funzione Automazione e Integrazioni.

🚀

Prova FlipLink Gratis

Converti il tuo PDF in pochi secondi. Senza registrazione, senza carta di credito — basta caricare il file.

Drop your PDF here or click to browse

Max 40MB

I piani a pagamento da $39 portano questo limite a 150 MB.

Esempio: Creare un Flipbook tramite API

Ecco un esempio base usando curl per creare un nuovo flipbook da un upload 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'

L'API restituisce una risposta JSON — {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} — con l'ID della pubblicazione e l'URL di condivisione che ti servono per distribuire il flipbook immediatamente. Hai già il PDF online? Sostituisci con POST /api/create-by-url e passa FileURL invece di File.

Puoi fare lo stesso in Python, Node.js o qualsiasi linguaggio che supporti HTTP. L'API è REST standard con corpi form-urlencoded (o multipart), quindi funziona con qualsiasi stack tu stia già utilizzando. Una cosa da ricordare: gli errori applicativi tornano come HTTP 200 con Result: "ERROR" (solo i fallimenti di autenticazione restituiscono 401), quindi ramifica sul campo Result.

Endpoint API Disponibili

Questa è solo una piccola parte — il catalogo completo di oltre 80 endpoint, ciascuno con i suoi parametri e una console Try-It live, si trova nel riferimento API.

Tutti gli endpoint restituiscono JSON. Il limite di frequenza è di 300 richieste al minuto per chiave API. Consulta il riferimento API per ogni endpoint, i suoi parametri, il modello di errore e i percorsi di dipendenza.

Quando Usare l'API vs. la Dashboard

Non tutto richiede una chiamata API. Ecco un semplice framework decisionale:

• Usa la dashboard quando crei un singolo flipbook, modifichi le impostazioni di design visivamente o esplori i dati analitici occasionalmente
• Usa l'API quando gestisci più di cinque pubblicazioni alla volta, integri con altri sistemi o automatizzi attività ricorrenti
• Usa le piattaforme di automazione (Zapier/Make/Pabbly) quando vuoi la potenza dell'API senza scrivere codice

Per i team che gestiscono cataloghi prodotti o qualsiasi contenuto che si aggiorna regolarmente, l'API si ripaga in tempo risparmiato dopo la prima esecuzione in blocco.

Inizia a Costruire

L'API di FlipLink trasforma il lavoro manuale ripetitivo in workflow automatizzati. Che tu stia sincronizzando i dati analitici con una dashboard, creando flipbook in blocco da una pipeline di contenuti o collegando FlipLink al tuo CRM — l'API ti dà il controllo per costruire esattamente ciò di cui hai bisogno.

Pronto per iniziare? Crea il tuo account FlipLink gratuito, genera la tua API key e apri il riferimento API per provare ogni endpoint live nel tuo browser. Consulta i nostri piani tariffari per vedere cosa è incluso con l'accesso API.