De PDF van een flipbook vervangen en hem dupliceren

Wat je kunt doen

Met deze endpoints wijzig je de PDF achter een flipbook die je al hebt gemaakt, of maak je er kopieën van — allemaal server-side, zonder iets helemaal opnieuw te maken:

• Vervang de PDF vanuit een bestand — upload een nieuwe PDF via multipart form data.
• Vervang de PDF vanuit een URL — geef de server een URL en die downloadt de nieuwe PDF.
• Dupliceer een flipbook — maak een of meer kopieën, elk met een eigen nieuwe ID en deel-URL.

Beide vervangmethoden behouden de ID, instellingen en deellink van de flipbook — alleen de PDF erachter verandert.

Voordat je begint

• Een API-sleutel — meegestuurd als de X-Api-Key-header, of als Authorization: Bearer YOUR_API_KEY, op elk verzoek.
• Basis-URL: https://go.fliplink.me.
• Alle drie de endpoints nemen de {flipbookId}-padparameter — de numerieke ID van de flipbook, teruggegeven door create-by-file / create-by-url (als ID) of door list.
• Replace PDF (URL) en Duplicate sturen hun body als form-urlencoded (geen JSON). Replace PDF (file) stuurt multipart form data.

De PDF vervangen vanuit een bestand

Multipart-upload. De server voegt de nieuwe PDF automatisch opnieuw samen met een eventuele bestaande voor-/achterpagina die nog aan de flipbook hangt. De flipbook behoudt zijn ID, instellingen en deellink.

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

Response:

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

De PDF vervangen vanuit een URL

Vervangt de PDF van een bestaande flipbook door een die de server downloadt van een URL die je opgeeft. De flipbook behoudt zijn ID, instellingen en deellink.

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'

Response:

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

Een flipbook dupliceren

Maakt een of meer server-side kopieën van een flipbook — elke kopie krijgt een eigen nieuwe ID en deel-URL. Count accepteert 1–500 en wordt server-side afgekapt.

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

Response:

{
  "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"
    }
  ]
}

Mogelijke fouten

Replace PDF (file) — PUT /api/replace-pdf/{flipbookId}:

• Ontbrekende of ongeldige API-sleutel → HTTP 401. Geeft een 401 Unauthorized-HTML-pagina terug — er is geen JSON-body.
• Item-ID niet gevonden of niet in eigendom van je sleutel → HTTP 200 met Message: "Item not found".
• Geüpload bestand is geen leesbare PDF → HTTP 200 met Message: "File is not a valid PDF.".
• Upload overschrijdt de maximale bestandsgrootte van het abonnement → HTTP 413 met Message: "File exceeds the maximum allowed upload size.".

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

• Ontbrekende of ongeldige API-sleutel → HTTP 401. Geeft een 401 Unauthorized-HTML-pagina terug — er is geen JSON-body.
• Item-ID niet gevonden of niet in eigendom van je sleutel → HTTP 200 met Message: "Item not found".
• Onbekend of verkeerd gespeld body-veld → HTTP 200 met Message: "Unknown field(s) '…'. Expected: …".

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

• Ontbrekende of ongeldige API-sleutel → HTTP 401. Geeft een 401 Unauthorized-HTML-pagina terug — er is geen JSON-body.
• Item-ID niet gevonden of niet in eigendom van je sleutel → HTTP 200 met Message: "Item not found".
• Onbekend of verkeerd gespeld body-veld → HTTP 200 met Message: "Unknown field(s) '…'. Expected: …".