FlipLink CLI
Maak, configureer, publiceer en beheer je flipbooks vanuit de terminal of CI — een dunne, scriptbare wrapper rond de FlipLink REST-API.
Installeert via npm · 87 commando's · JSON-uitvoer om mee te scripten
Installeren
npm install -g fliplink-cli
# or run without installing:
npx fliplink-cli whoamiVereist Node.js 18 of nieuwer.
Authenticeren
Haal een API-sleutel op uit je FlipLink-dashboard → Abonnement en bewaar hem dan:
fliplink config set-key YOUR_API_KEY
fliplink whoamiOf geef hem per aanroep mee (handig in CI — wordt nooit naar schijf geschreven):
FLIPLINK_API_KEY=YOUR_API_KEY fliplink flipbook listVolgorde van resolutie voor elke instelling: omgevingsvariabele → configuratiebestand → ingebouwde standaard. De opgeslagen sleutel staat in ~/.config/fliplink/config.json met chmod 600-rechten.
Veelgebruikte commando's
fliplink flipbook create ./deck.pdf --title "Q3 Report" --name q3
fliplink flipbook create-url https://example.com/deck.pdf --title "Q3 Report"
fliplink flipbook list --search report --page-size 25 --sort-by CreatedOn
fliplink flipbook get <flipbookId>
fliplink flipbook publish <flipbookId>
fliplink flipbook unpublish <flipbookId>
fliplink flipbook set-expiry <flipbookId> --days 30
fliplink flipbook share-link <flipbookId>
fliplink flipbook delete <flipbookId>
fliplink leads list --item <flipbookId> --download trueVoer fliplink <command> --help uit voor de vlaggen van een commando.
Alle commandogroepen
Elk endpoint is bereikbaar als een benoemd commando. Voer fliplink <group> --help uit om de commando's van een groep op te sommen.
| Groep | Omvat |
|---|---|
| flipbook | maken / lezen / wijzigen / verwijderen + alle instellingen per flipbook (skin, CTA's, leadgeneratie, toegang, delen, verkoop, tracking, …) |
| profile | get, set |
| account | abonnement, betalingen |
| folder | list |
| cname | add, list, delete (eigen domeinen) |
| team | list, get, set, set-active, delete |
| leads | list, delete, delete-bulk |
| sales | list |
| lookup | templates, skins, valuta, achtergrondmuziek |
Google Sheets-endpoints gebruiken een andere basis-URL en zijn alleen bereikbaar via de api-noodingang.
Scripting
Elk commando print standaard een leesbare tabel en met --json ruwe JSON:
fliplink flipbook list --json | jq '.[].ID'Afsluitcodes: 0 succes · 1 verzoek-/HTTP-fout · 2 applicatiefout (Result: ERROR).
Shell-aanvulling
Genereer een aanvullingsscript voor je shell:
source <(fliplink completion zsh) # add to ~/.zshrc
source <(fliplink completion bash) # add to ~/.bashrcNoodingang — elk endpoint, vandaag al
Elk endpoint dat nog niet in een handig commando is verpakt, is rechtstreeks bereikbaar:
fliplink api GET /api/list-folders
fliplink api PUT /api/set-skin/<flipbookId> --data '{"SkinName":"Modern"}'
fliplink api POST /api/create-by-file --file File=./deck.pdf -q Name=deckBlader door elk endpoint, de bijbehorende parameters en responses in de volledige REST API-referentie.
Hoe het werkt
Het commando-oppervlak wordt gegenereerd uit de API-specificatie — dezelfde endpoints.json die de REST-API-documentatie aandrijft — zodat de CLI niet kan afwijken van de gedocumenteerde API. Liever natuurlijke taal? Dezelfde API is ook beschikbaar als MCP-server voor AI-assistenten.
Veelgestelde vragen
- Hoe installeer ik de FlipLink CLI?
Voer
npm install -g fliplink-cliuit (vereist Node.js 18+), of gebruik de tool zonder te installeren vianpx fliplink-cli whoami.- Hoe authenticeer ik in CI?
Geef je sleutel mee als de omgevingsvariabele
FLIPLINK_API_KEY— bijvoorbeeldFLIPLINK_API_KEY=YOUR_KEY fliplink flipbook list. Die wordt nooit naar schijf weggeschreven. Lokaal kun je hem eenmalig opslaan metfliplink config set-key.- Wat is de API-escape hatch?
Elk endpoint dat nog niet in een handig commando is verpakt, bereik je rechtstreeks met
fliplink api <METHOD> <path>, zodat de CLI vanaf dag één de volledige REST API dekt.- Kan ik de CLI scripten?
Ja. Elk commando print standaard een tabel en met
--jsonruwe JSON (pipe die naarjq). De exitcodes zijn scriptbaar:0geslaagd,1request-/HTTP-fout,2applicatiefout (Result: ERROR).- Hoeveel commando's zijn er?
87 commando's verdeeld over 9 groepen (flipbook, profile, account, folder, cname, team, leads, sales, lookup), gegenereerd uit dezelfde API-spec als de REST API, zodat de CLI niet kan afwijken van de gedocumenteerde endpoints.