Aan de slag met de FlipLink CLI

Als je in de terminal leeft, voelt het doorklikken in een dashboard om een flipbook te publiceren als een omweg. Met de FlipLink CLI doe je het hele proces — maken, publiceren en delen — zonder je shell te verlaten. Het is een dunne, scriptbare schil rond de FlipLink API, dus alles wat je met een HTTP-verzoek kunt doen, doe je met één commando.

Deze gids brengt je in ongeveer vijf minuten van nul naar een gepubliceerde, deelbare flipbook. Aan het eind heb je de CLI geïnstalleerd, ben je ingelogd en produceer je een openbare URL rechtstreeks vanuit een PDF.

Installeer de CLI

De CLI wordt geleverd als npm-pakket en heeft Node.js 18 of nieuwer nodig. Installeer hem globaal zodat het commando fliplink overal beschikbaar is:

npm install -g fliplink-cli

Liever niks permanent installeren? Je kunt elk commando op aanvraag uitvoeren met npx:

npx fliplink-cli whoami

Hoe dan ook, je hebt steeds dezelfde commando's tot je beschikking. De rest van deze gids gaat uit van een globale installatie.

Stel je API-sleutel in

Elk commando logt in met je FlipLink API-sleutel. Haal er een op door in te loggen op https://go.fliplink.me en de pagina Subscription te openen.

Sla de sleutel één keer op, dan onthoudt de CLI hem:

fliplink config set-key YOUR_API_KEY

Dit schrijft de sleutel naar ~/.config/fliplink/config.json met 600-rechten, zodat alleen jouw gebruiker hem kan lezen. Voor CI/CD of scripts waarin je liever geen configuratiebestand wegschrijft, stel je in plaats daarvan een omgevingsvariabele in:

export FLIPLINK_API_KEY=YOUR_API_KEY

De CLI zoekt de inloggegevens in deze volgorde: eerst de omgevingsvariabele FLIPLINK_API_KEY, daarna het configuratiebestand. Behandel de sleutel als een wachtwoord — commit hem nooit naar een repo. Wil je dieper begrijpen hoe deze header-gebaseerde authenticatie werkt, dan is het API-begrip in de woordenlijst een goed startpunt.

Controleer of je verbonden bent

Voer eerst even een snelle gezondheidscheck uit voordat je iets anders doet. whoami roept het account-identiteitseindpunt aan en bevestigt dat je sleutel werkt:

fliplink whoami

Een geslaagd antwoord toont je accountgegevens (en je maximale uploadgrootte). Zie je een authenticatiefout, dan ontbreekt je sleutel of is hij verkeerd — voer config set-key opnieuw uit en probeer het nog eens. Dit is precies dezelfde eerste aanroep die we ook voor de API zelf aanraden, dus het is een betrouwbare rooktest.

Maak een flipbook van een PDF

Nu het leuke werk. Wijs de CLI naar een lokale PDF en geef hem een titel:

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

--title is wat lezers zien, en --name is een intern label waarmee je het later terugvindt. Het commando uploadt het bestand, start de conversie en geeft de ID van de nieuwe flipbook terug. Noteer die ID — die heb je voor de volgende twee stappen nodig.

Heb je de PDF al ergens online staan? Sla de upload over en maak hem in plaats daarvan vanuit een URL:

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

🚀

Probeer FlipLink Gratis

Converteer je PDF in seconden. Geen registratie, geen creditcard — gewoon uploaden en starten.

Drop your PDF here or click to browse

Max. 40MB

Met een betaald abonnement vanaf $39 verhoog je dit naar 150 MB.

Publiceren en delen

Een net gemaakte flipbook is pas openbaar als je hem publiceert. Hier is de volledige reeks — maken, publiceren en dan de deellink ophalen — waarbij je de ID gebruikt die je bij elke stap terugkrijgt:

# 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 zet de flipbook live; share-link geeft de URL terug die je aan lezers doorgeeft. Van gedachten veranderd? Met fliplink flipbook unpublish 90001 haal je hem weer offline zonder iets te verwijderen.

Machine-leesbare uitvoer met --json

Standaard toont de CLI mensvriendelijke uitvoer. Voeg --json toe aan elk commando om in plaats daarvan het ruwe JSON-antwoord te krijgen — perfect om door te sluizen naar jq of om een waarde in een script vast te leggen:

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

Die one-liner maakt een flipbook en print niets anders dan de ID, klaar om door te geven aan het volgende commando. Dit is de basis van elke automatisering die je bouwt — zie Automatisering en integraties voor waar het toe leidt.

Exitcodes voor scripts

De CLI gebruikt voorspelbare exitcodes, zodat je scripts kunnen vertakken op succes of mislukking zonder de uitvoer te parsen:

Dat onderscheid is belangrijk: een 2 betekent dat je verzoek FlipLink bereikte maar om een zakelijke reden werd geweigerd (ongeldige invoer, quotum overschreden), terwijl een 1 betekent dat het verzoek zelf mislukte. In een shellscript kun je daarop reageren:

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

Hoe nu verder

Je hebt nu de kernlus: installeren, inloggen, maken, publiceren, delen. Vanaf hier kun je de CLI koppelen aan alles wat commando's uitvoert.

• Volledige commandoreferentie — elke vlag en elk subcommando vind je in de CLI-documentatie.
• Automatiseer het — voer dezelfde reeks uit volgens een schema of per commit. Onze gids over flipbook-publicatie automatiseren in CI/CD loopt een echte pipeline door.
• Ruwe API-kracht nodig? — de CLI is een schil rond de API-referentie, en met de fliplink api-uitweg bereik je elk eindpunt dat de benoemde commando's nog niet dekken.

Zodra je je eerste flipbook vanuit de terminal hebt gepubliceerd, begint het dashboard optioneel te voelen — en dat is precies de bedoeling.

Verder lezen

• FlipLink CLI-documentatie — de complete commandoreferentie
• CLI vs API vs MCP: welke moet je gebruiken?
• Flipbook-publicatie automatiseren in CI/CD
• Hoe je de FlipLink API gebruikt voor maatwerkintegraties
• Automatisering en integraties
• Wat is een API? (woordenlijst)