Come iniziare con la CLI di FlipLink

Se vivi nel terminale, cliccare in una dashboard per pubblicare un flipbook sembra una deviazione. La CLI di FlipLink ti permette di fare tutto — creare, pubblicare e condividere — senza uscire dalla shell. È un wrapper leggero e scriptabile sopra l'API di FlipLink: tutto ciò che puoi fare con una richiesta HTTP, puoi farlo con un solo comando.

Questa guida ti porta da zero a un flipbook pubblicato e condivisibile in circa cinque minuti. Alla fine avrai la CLI installata, autenticata e pronta a generare un URL pubblico direttamente da un PDF.

Installa la CLI

La CLI viene distribuita come pacchetto npm e richiede Node.js 18 o superiore. Installala a livello globale così il comando fliplink è disponibile ovunque:

npm install -g fliplink-cli

Preferisci non installare nulla in modo permanente? Puoi eseguire qualsiasi comando al volo con npx:

npx fliplink-cli whoami

In entrambi i casi hai a disposizione la stessa serie di comandi. Il resto di questa guida presuppone un'installazione globale.

Imposta la tua chiave API

Ogni comando si autentica con la tua chiave API di FlipLink. Ottienine una accedendo su https://go.fliplink.me e aprendo la pagina Subscription.

Salva la chiave una volta sola e la CLI la ricorderà:

fliplink config set-key YOUR_API_KEY

Questo scrive la chiave in ~/.config/fliplink/config.json con permessi 600, così solo il tuo utente può leggerla. Per CI/CD o script in cui preferisci non scrivere un file di configurazione, imposta invece una variabile d'ambiente:

export FLIPLINK_API_KEY=YOUR_API_KEY

La CLI risolve le credenziali in quest'ordine: prima la variabile d'ambiente FLIPLINK_API_KEY, poi il file di configurazione. Tratta la chiave come una password — non inserirla mai in un repository. Se vuoi approfondire come funziona questa autenticazione basata sull'header, la voce di glossario sull'API è un buon punto di partenza.

Verifica di essere connesso

Prima di fare qualsiasi altra cosa, esegui un rapido controllo. whoami chiama l'endpoint di identità dell'account e conferma che la tua chiave funziona:

fliplink whoami

Una risposta riuscita mostra i dati del tuo account (e la dimensione massima di caricamento). Se vedi un errore di autenticazione, la tua chiave manca o è sbagliata — riesegui config set-key e riprova. Questa è la stessa prima chiamata che consigliamo per l'API stessa, quindi è un test rapido affidabile.

Crea un flipbook da un PDF

Ora arriva la parte divertente. Indica alla CLI un PDF locale e dagli un titolo:

fliplink flipbook create ./deck.pdf --title "Q3 Report" --name q3

--title è ciò che vedono i lettori, mentre --name è un'etichetta interna che userai per ritrovarlo più tardi. Il comando carica il file, avvia la conversione e restituisce l'ID del nuovo flipbook. Prendi nota di quell'ID — ti servirà per i due passaggi successivi.

Hai già il PDF ospitato da qualche parte? Salta il caricamento e crealo da un URL:

fliplink flipbook create-url https://example.com/deck.pdf --title "Q3 Report"

🚀

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.

Pubblica e condividi

Un flipbook appena creato non è pubblico finché non lo pubblichi. Ecco la sequenza completa — creare, pubblicare e poi recuperare il link di condivisione — usando l'ID restituito a ogni passaggio:

# 1. Create from a PDF and note the returned ID
fliplink flipbook create ./deck.pdf --title "Q3 Report" --name q3

# 2. Publish it (use the ID from step 1)
fliplink flipbook publish 90001

# 3. Get the public share link
fliplink flipbook share-link 90001

publish rende il flipbook attivo; share-link restituisce l'URL da consegnare ai lettori. Hai cambiato idea? fliplink flipbook unpublish 90001 lo rimette offline senza eliminare nulla.

Output leggibile dalle macchine con --json

Per impostazione predefinita la CLI mostra un output leggibile dalle persone. Aggiungi --json a qualsiasi comando per ottenere invece la risposta JSON grezza — perfetto per il piping in jq o per catturare un valore in uno script:

fliplink flipbook create ./deck.pdf --title "Q3 Report" --json | jq -r '.ID'

Quel one-liner crea un flipbook e stampa solo il suo ID, pronto da passare al comando successivo. Questa è la base di ogni automazione che costruirai — vedi Automazione e integrazioni per scoprire dove può portarti.

Codici di uscita per lo scripting

La CLI usa codici di uscita prevedibili, così i tuoi script possono ramificarsi in caso di successo o fallimento senza analizzare l'output:

Questa distinzione è importante: un 2 significa che la tua richiesta ha raggiunto FlipLink ma è stata rifiutata per un motivo di business (input non valido, quota superata), mentre un 1 significa che la richiesta stessa è fallita. In uno script di shell puoi reagire di conseguenza:

fliplink flipbook publish 90001 || echo "Publish failed with exit code $?"

Dove andare da qui

Ora hai il ciclo fondamentale: installare, autenticare, creare, pubblicare, condividere. Da qui puoi collegare la CLI a qualsiasi cosa che esegua comandi.

• Riferimento completo dei comandi — ogni flag e sottocomando si trova nella documentazione della CLI.
• Automatizzala — esegui la stessa sequenza secondo una pianificazione o a ogni commit. La nostra guida su come automatizzare la pubblicazione dei flipbook in CI/CD illustra una pipeline reale.
• Ti serve la potenza grezza dell'API? — la CLI fa da wrapper all'API reference, e l'escape hatch fliplink api raggiunge qualsiasi endpoint che i comandi dedicati non coprono ancora.

Una volta pubblicato il tuo primo flipbook dal terminale, la dashboard inizia a sembrare opzionale — che è esattamente il punto.

Letture correlate

• Documentazione della CLI di FlipLink — il riferimento completo dei comandi
• CLI, API o MCP: quale dovresti usare?
• Automatizza la pubblicazione dei flipbook in CI/CD
• Come usare l'API di FlipLink per integrazioni personalizzate
• Automazione e integrazioni
• Che cos'è un'API? (glossario)