Das PDF eines Flipbooks ersetzen und es duplizieren

Was du tun kannst

Mit diesen Endpunkten änderst du das PDF hinter einem bereits erstellten Flipbook oder legst Kopien davon an – alles serverseitig, ohne etwas von Grund auf neu zu erstellen:

• Das PDF aus einer Datei ersetzen – lade ein neues PDF per Multipart-Formdaten hoch.
• Das PDF aus einer URL ersetzen – gib dem Server eine URL, und er lädt das neue PDF herunter.
• Duplizieren eines Flipbooks – erstelle eine oder mehrere Kopien, jede mit ihrer eigenen neuen ID und Share-URL.

Beide Ersetzungsmethoden behalten die ID, Einstellungen und den Share-Link des Flipbooks – nur das PDF dahinter ändert sich.

Bevor du loslegst

• Einen API-Schlüssel – wird bei jeder Anfrage als X-Api-Key-Header oder als Authorization: Bearer YOUR_API_KEY gesendet.
• Basis-URL: https://go.fliplink.me.
• Alle drei Endpunkte nehmen den Pfadparameter {flipbookId} entgegen – die numerische ID des Flipbooks, zurückgegeben von create-by-file / create-by-url (als ID) oder von list.
• Replace PDF (URL) und Duplicate senden ihre Bodys als form-urlencoded (kein JSON). Replace PDF (Datei) sendet Multipart-Formdaten.

Das PDF aus einer Datei ersetzen

Multipart-Upload. Der Server führt das neue PDF automatisch erneut mit einer noch am Flipbook hängenden Titel-/Rückseite zusammen. Das Flipbook behält seine ID, Einstellungen und den Share-Link.

curl -X PUT 'https://go.fliplink.me/api/replace-pdf/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@/path/to/file'

Antwort:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

Das PDF aus einer URL ersetzen

Ersetzt das PDF eines bestehenden Flipbooks durch eines, das der Server von einer von dir angegebenen URL herunterlädt. Das Flipbook behält seine ID, Einstellungen und den Share-Link.

curl -X PUT 'https://go.fliplink.me/api/replace-pdf-by-url/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'File=https://example.com/new.pdf'

Antwort:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

Ein Flipbook duplizieren

Erstellt eine oder mehrere serverseitige Kopien eines Flipbooks – jede Kopie erhält ihre eigene neue ID und Share-URL. Count akzeptiert 1–500 und wird serverseitig begrenzt.

curl -X POST 'https://go.fliplink.me/api/duplicate/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Count=3'

Antwort:

{
  "Result": "OK",
  "Count": 3,
  "Items": [
    {
      "ID": "93213",
      "URL": "https://go.fliplink.me/C73371B4-B041-4EBD-A518-1E5B5B56DA44"
    },
    {
      "ID": "93214",
      "URL": "https://go.fliplink.me/2F9A0C7D-6E51-4B22-A9F0-7D3C1E8B4A15"
    },
    {
      "ID": "93215",
      "URL": "https://go.fliplink.me/8B4E2A19-C037-45D6-9E1B-4A6F0D2C7E83"
    }
  ]
}

Mögliche Fehler

Replace PDF (Datei) – PUT /api/replace-pdf/{flipbookId}:

• Fehlender oder ungültiger API-Schlüssel → HTTP 401. Gibt eine 401-Unauthorized-HTML-Seite zurück – es gibt keinen JSON-Body.
• Item-ID nicht gefunden oder nicht im Besitz deines Schlüssels → HTTP 200 mit Message: "Item not found".
• Hochgeladene Datei ist kein lesbares PDF → HTTP 200 mit Message: "File is not a valid PDF.".
• Upload überschreitet die maximale Dateigröße des Tarifs → HTTP 413 mit Message: "File exceeds the maximum allowed upload size.".

Replace PDF (URL) – PUT /api/replace-pdf-by-url/{flipbookId}:

• Fehlender oder ungültiger API-Schlüssel → HTTP 401. Gibt eine 401-Unauthorized-HTML-Seite zurück – es gibt keinen JSON-Body.
• Item-ID nicht gefunden oder nicht im Besitz deines Schlüssels → HTTP 200 mit Message: "Item not found".
• Unbekanntes oder falsch geschriebenes Body-Feld → HTTP 200 mit Message: "Unknown field(s) '…'. Expected: …".

Duplicate – POST /api/duplicate/{flipbookId}:

• Fehlender oder ungültiger API-Schlüssel → HTTP 401. Gibt eine 401-Unauthorized-HTML-Seite zurück – es gibt keinen JSON-Body.
• Item-ID nicht gefunden oder nicht im Besitz deines Schlüssels → HTTP 200 mit Message: "Item not found".
• Unbekanntes oder falsch geschriebenes Body-Feld → HTTP 200 mit Message: "Unknown field(s) '…'. Expected: …".