Sostituire il PDF di un flipbook e duplicarlo

Cosa puoi fare

Questi endpoint ti permettono di cambiare il PDF dietro a un flipbook che hai già creato, o di generarne copie — tutto lato server, senza ricreare nulla da zero:

• Sostituire il PDF da un file — carica un nuovo PDF tramite multipart form data.
• Sostituire il PDF da un URL — passa un URL al server e lui scarica il nuovo PDF.
• Duplicare un flipbook — crea una o più copie, ognuna con il proprio nuovo ID e URL di condivisione.

Entrambi i metodi di sostituzione mantengono l'ID, le impostazioni e il link di condivisione del flipbook — cambia solo il PDF dietro di esso.

Prima di iniziare

• Una chiave API — inviata come header X-Api-Key, o come Authorization: Bearer YOUR_API_KEY, in ogni richiesta.
• URL di base: https://go.fliplink.me.
• Tutti e tre gli endpoint accettano il parametro {flipbookId} nel percorso — l'ID numerico del flipbook, restituito da create-by-file / create-by-url (come ID) o da list.
• Replace PDF (URL) e Duplicate inviano i loro body come form-urlencoded (non JSON). Replace PDF (file) invia multipart form data.

Sostituire il PDF da un file

Upload multipart. Il server riunisce automaticamente il nuovo PDF con qualsiasi pagina anteriore/posteriore ancora collegata al flipbook. Il flipbook mantiene il suo ID, le impostazioni e il link di condivisione.

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

Risposta:

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

Sostituire il PDF da un URL

Sostituisce il PDF di un flipbook esistente con uno che il server scarica da un URL che fornisci. Il flipbook mantiene il suo ID, le impostazioni e il link di condivisione.

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'

Risposta:

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

Duplicare un flipbook

Crea una o più copie lato server di un flipbook — ogni copia ottiene il proprio nuovo ID e URL di condivisione. Count accetta valori da 1 a 500 e viene limitato lato server.

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

Risposta:

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

Errori possibili

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

• Chiave API mancante o non valida → HTTP 401. Restituisce una pagina HTML 401 Unauthorized — non c'è alcun body JSON.
• ID dell'elemento non trovato o non di proprietà della tua chiave → HTTP 200 con Message: "Item not found".
• Il file caricato non è un PDF leggibile → HTTP 200 con Message: "File is not a valid PDF.".
• L'upload supera la dimensione massima del file del piano → HTTP 413 con Message: "File exceeds the maximum allowed upload size.".

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

• Chiave API mancante o non valida → HTTP 401. Restituisce una pagina HTML 401 Unauthorized — non c'è alcun body JSON.
• ID dell'elemento non trovato o non di proprietà della tua chiave → HTTP 200 con Message: "Item not found".
• Campo del body sconosciuto o scritto male → HTTP 200 con Message: "Unknown field(s) '…'. Expected: …".

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

• Chiave API mancante o non valida → HTTP 401. Restituisce una pagina HTML 401 Unauthorized — non c'è alcun body JSON.
• ID dell'elemento non trovato o non di proprietà della tua chiave → HTTP 200 con Message: "Item not found".
• Campo del body sconosciuto o scritto male → HTTP 200 con Message: "Unknown field(s) '…'. Expected: …".