FlipLink skripten: CLI-Ausgabe an jq weiterleiten

Die FlipLink CLI gibt standardmäßig freundliche, gut lesbare Tabellen aus. Das ist großartig, wenn du am Terminal arbeitest — aber sobald du etwas skripten willst, brauchst du stattdessen rohe, maschinenlesbare Daten. Genau das liefert dir das --json-Flag, und sobald du es mit jq kombinierst, kannst du IDs extrahieren, Freigabe-Links abrufen, nach Status filtern und Befehle zu echter Automatisierung verketten.

In diesem Leitfaden geht es darum, die FlipLink CLI zu skripten: ein paar Befehle in eine kleine, zuverlässige Pipeline zu verwandeln. Wenn du ganz neu mit dem Tool bist, beginne mit Erste Schritte mit der FlipLink CLI und komm dann hierher zurück. Für den vollständigen Befehlsumfang ist die CLI-Dokumentation die Referenz.

Das eine Flag, das Skripting möglich macht: --json

Fast jeder Lese- oder Schreibbefehl akzeptiert --json. Füge es hinzu, und die CLI gibt rohes JSON an die Standardausgabe aus statt einer formatierten Tabelle:

fliplink flipbook list --json

Leite das direkt an jq weiter, und du kannst es nach Belieben umformen. Die wichtigste Gewohnheit beim Skripten: sieh dir zuerst die rohe Ausgabe an, damit du die genauen Feldnamen kennst, bevor du darauf zugreifst.

# See the full shape of a single item — keys, casing, everything
fliplink flipbook list --json | jq '.[0]'

Die folgenden Beispiele verwenden plausible Feldnamen wie .ID und .URL, aber du solltest sie nie als selbstverständlich ansehen — die Groß-/Kleinschreibung der Felder kann abweichen. Führe den obigen Befehl einmal aus, lies die Schlüssel und passe deine jq-Pfade an das an, was du tatsächlich siehst.

Nur die IDs extrahieren

Der klassische erste Schritt: eine flache Liste von Flipbook-IDs, über die du in einer Schleife iterieren kannst.

fliplink flipbook list --json | jq '.[].ID'

jq durchläuft das Array (.[]) und zieht das ID-Feld aus jedem Element. Setze das Feld in -r (rohe Ausgabe), wenn du saubere Zeichenketten ohne umschließende Anführungszeichen möchtest — genau das brauchst du, wenn du die Werte an einen anderen Befehl übergibst:

fliplink flipbook list --json | jq -r '.[].ID'

Freigabe-Links in eine saubere Liste ziehen

Dasselbe Muster funktioniert für jedes Feld. Wenn deine Listenelemente eine URL enthalten, kannst du jeden Freigabe-Link auf einmal extrahieren:

fliplink flipbook list --json | jq -r '.[].URL'

Möchtest du einen zweispaltigen Bericht aus Titel und Link? Baue mit jqs String-Interpolation eine tabulatorgetrennte Zeile pro Element:

fliplink flipbook list --json \
  | jq -r '.[] | "\(.Title)\t\(.URL)"'

Auch hier — bestätige .Title und .URL anhand deiner eigenen --json-Ausgabe, bevor du dich darauf verlässt. Wenn die Schlüssel abweichen, tausche sie aus.

Filtern, bevor du handelst

jqs select() lässt dich nur die Elemente behalten, die eine Bedingung erfüllen. Angenommen, jedes Element trägt ein Veröffentlicht-Flag und du möchtest nur die IDs der veröffentlichten Flipbooks:

fliplink flipbook list --json \
  | jq -r '.[] | select(.IsPublished == true) | .ID'

Sieh dir deine Ausgabe an, um den echten Flag-Namen und -Typ herauszufinden — es könnte ein Boolean, eine Zeichenkette oder ein Status-Feld sein. Passe den select()-Ausdruck entsprechend an. Das Muster bleibt dasselbe: Filtere das Array und projiziere dann das Feld, das du brauchst.

Befehle verketten: auflisten, filtern, dann handeln

Hier wird es nützlich. Leite die gefilterten IDs in eine Shell-Schleife und führe einen zweiten Befehl für jede einzelne aus. Dieses Beispiel findet jedes Flipbook, das noch nicht veröffentlicht ist, und veröffentlicht es:

fliplink flipbook list --json \
  | jq -r '.[] | select(.IsPublished == false) | .ID' \
  | while read -r id; do
      echo "Publishing $id..."
      fliplink flipbook publish "$id"
    done

Die Schleife while read -r id verarbeitet eine ID pro Zeile und ruft für jede fliplink flipbook publish auf. Weil jq -r die Anführungszeichen entfernt, ist $id ein sauberer Wert, der direkt durchgereicht werden kann. Dieselbe Struktur funktioniert für jeden Aktionsbefehl — tausche einfach set-expiry, share-link oder delete ein.

Hinweis: Jeder hier gezeigte Befehl ist ein echter FlipLink-CLI-Befehl. Wenn du eine Aktion brauchst, die die kuratierten Befehle nicht abdecken, nutze den fliplink api-Notausgang (zum Beispiel fliplink api PUT /api/set-skin/<id> --data '{"SkinName":"Modern"}') — darunter liegt dieselbe REST-API.

🚀

FlipLink kostenlos testen

Wandle dein PDF in Sekunden um. Keine Anmeldung, keine Kreditkarte — einfach hochladen und loslegen.

Drop your PDF here or click to browse

Max. 40 MB

Bezahlte Tarife ab $39 erhöhen das auf 150 MB.

Einen kleinen Bericht bauen

Sobald du extrahieren und filtern kannst, ist ein schneller Statusbericht nur noch ein weiterer jq-Ausdruck. Zähle deine Flipbooks insgesamt und wie viele davon veröffentlicht sind:

fliplink flipbook list --json | jq '{
  total: length,
  published: ([.[] | select(.IsPublished == true)] | length)
}'

Das gibt eine kompakte JSON-Zusammenfassung aus, die du protokollieren, per E-Mail versenden oder in einen Channel posten kannst. Lieber eine menschenlesbare Zeile?

fliplink flipbook list --json \
  | jq -r '"Total: \(length) flipbooks"'

Skripte schreiben, die wissen, ob sie funktioniert haben

Eine Pipeline ist nur dann vertrauenswürdig, wenn sie auf Fehler reagiert. Die FlipLink CLI verwendet aussagekräftige Exit-Codes, sodass deine Skripte je nach Code verzweigen können:

• 0 — Erfolg
• 1 — Anfrage- oder HTTP-Fehler (Netzwerk, falscher Schlüssel, ein 401)
• 2 — Anwendungsfehler (die API hat Result: ERROR zurückgegeben)

Prüfe den Exit-Code nach einem Befehl und behandle jeden Fall:

fliplink flipbook publish "$id"
status=$?

if [ "$status" -eq 0 ]; then
  echo "Published $id"
elif [ "$status" -eq 2 ]; then
  echo "Application error publishing $id (check the response)" >&2
else
  echo "Request failed for $id (exit $status)" >&2
fi

Für ein Fail-Fast-Skript füge oben set -e hinzu, damit der gesamte Lauf beim ersten Exit ungleich null stoppt. Für einen robusten Batch-Job mach weiter, aber protokolliere die Fehler — der Exit-Code-Zweig oben ist die Art, wie du “fertig” von “fertig mit Fehlern” unterscheidest.

Wenn du in der CI skriptest statt von deinem Laptop, setze deinen Schlüssel über die Umgebungsvariable FLIPLINK_API_KEY statt über die lokale Konfigurationsdatei und lies die ausführlichere Anleitung in Flipbook-Veröffentlichung in CI/CD automatisieren.

Per Cron ausführen

Der letzte Schritt jeder Automatisierung: sie auf einen Zeitplan setzen. Speichere deine Pipeline als Skript, mach es ausführbar und füge einen cron-Eintrag hinzu. Dies führt nächtlich um 02:00 Uhr eine Veröffentlichung mit Bericht aus:

# crontab -e
0 2 * * * FLIPLINK_API_KEY=your_key /home/you/scripts/nightly-publish.sh >> /var/log/fliplink.log 2>&1

Indem du sowohl stdout als auch stderr in eine Logdatei umleitest (>> ... 2>&1), werden deine Exit-Code-Zweige und jq-Berichte bei jedem Lauf erfasst — wenn also um 2 Uhr morgens etwas kaputtgeht, hast du eine Aufzeichnung darüber, was genau passiert ist.

Das Muster, in einer Zeile

Jedes Skript in diesem Leitfaden folgt derselben Idee: --json, um rohe Daten zu bekommen → jq, um zu extrahieren oder zu filtern → eine Schleife, um zu handeln → Exit-Codes, um zu überprüfen. Beginne damit, deine eigene --json-Ausgabe zu inspizieren, damit die Feldnamen stimmen, baue die Pipeline Stufe für Stufe auf, und du hast in wenigen Minuten eine verlässliche FlipLink-Automatisierung.

Weiterführende Lektüre

• FlipLink-CLI-Dokumentation
• Erste Schritte mit der FlipLink CLI
• Einen Ordner mit PDFs stapelweise in Flipbooks umwandeln
• Flipbook-Veröffentlichung in CI/CD automatisieren
• FlipLink-API-Referenz
• Was ist eine API? (Glossar)