Remplacer le PDF d'un flipbook et le dupliquer

Ce que tu peux faire

Ces endpoints te permettent de changer le PDF derrière un flipbook que tu as déjà créé, ou d'en générer des copies — le tout côté serveur, sans rien recréer de zéro :

• Remplace le PDF à partir d'un fichier — téléverse un nouveau PDF via multipart form data.
• Remplace le PDF à partir d'une URL — donne une URL au serveur et il télécharge le nouveau PDF.
• Duplique un flipbook — crée une ou plusieurs copies, chacune avec son propre nouvel ID et son URL de partage.

Les deux méthodes de remplacement conservent l'ID, les paramètres et le lien de partage du flipbook — seul le PDF derrière lui change.

Avant de commencer

• Une clé d'API — envoyée dans l'en-tête X-Api-Key, ou via Authorization: Bearer YOUR_API_KEY, à chaque requête.
• URL de base : https://go.fliplink.me.
• Les trois endpoints prennent le paramètre de chemin {flipbookId} — l'ID numérique du flipbook, renvoyé par create-by-file / create-by-url (sous ID) ou par list.
• Replace PDF (URL) et Duplicate envoient leur corps en form-urlencoded (pas du JSON). Replace PDF (file) envoie du multipart form data.

Remplacer le PDF à partir d'un fichier

Téléversement multipart. Le serveur refusionne automatiquement le nouveau PDF avec toute page avant/arrière encore attachée au flipbook. Le flipbook conserve son ID, ses paramètres et son lien de partage.

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

Réponse :

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

Remplacer le PDF à partir d'une URL

Remplace le PDF d'un flipbook existant par un PDF que le serveur télécharge depuis une URL que tu fournis. Le flipbook conserve son ID, ses paramètres et son lien de partage.

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'

Réponse :

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

Dupliquer un flipbook

Crée une ou plusieurs copies côté serveur d'un flipbook — chaque copie obtient son propre nouvel ID et son URL de partage. Count accepte 1 à 500 et est borné côté serveur.

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

Réponse :

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

Erreurs possibles

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

• Clé d'API manquante ou invalide → HTTP 401. Renvoie une page HTML 401 Unauthorized — il n'y a pas de corps JSON.
• ID d'élément introuvable ou non rattaché à ta clé → HTTP 200 avec Message: "Item not found".
• Le fichier téléversé n'est pas un PDF lisible → HTTP 200 avec Message: "File is not a valid PDF.".
• Le téléversement dépasse la taille de fichier maximale de l'offre → HTTP 413 avec Message: "File exceeds the maximum allowed upload size.".

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

• Clé d'API manquante ou invalide → HTTP 401. Renvoie une page HTML 401 Unauthorized — il n'y a pas de corps JSON.
• ID d'élément introuvable ou non rattaché à ta clé → HTTP 200 avec Message: "Item not found".
• Champ du corps inconnu ou mal orthographié → HTTP 200 avec Message: "Unknown field(s) '…'. Expected: …".

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

• Clé d'API manquante ou invalide → HTTP 401. Renvoie une page HTML 401 Unauthorized — il n'y a pas de corps JSON.
• ID d'élément introuvable ou non rattaché à ta clé → HTTP 200 avec Message: "Item not found".
• Champ du corps inconnu ou mal orthographié → HTTP 200 avec Message: "Unknown field(s) '…'. Expected: …".