Immagini di copertina e anteprima

Cosa puoi fare

Due endpoint di scrittura controllano i PDF che fanno da sostituto per un flipbook prima che un lettore ottenga l'accesso completo:

• Impostare il PDF di anteprima mostrato ai lettori prima della cattura lead / del pagamento.
• Impostare il PDF immagine usato per miniature e anteprime.

Ogni chiamata agisce su un flipbook tramite il suo {flipbookId} e restituisce un semplice risultato di successo.

Prima di iniziare

Ti serviranno:

• Una chiave API — inviata come header X-Api-Key, o come Authorization: Bearer YOUR_API_KEY, in ogni richiesta.
• Il {flipbookId} — l'ID numerico del flipbook/documento, restituito da create-by-file / create-by-url (come ID) o da list.
• Tutte le richieste vanno all'URL di base https://go.fliplink.me.

Entrambi gli endpoint accettano un body form-urlencoded (non JSON).

Impostare il PDF di anteprima

PUT /api/set-preview-pdf/{flipbookId} imposta il PDF di anteprima mostrato ai lettori prima della cattura lead / del pagamento. Viene azzerato automaticamente se sia la cattura lead sia la modalità di vendita sono disattivate.

Invia l'URL del PDF da usare come PreviewPDF:

• PreviewPDF — l'URL del PDF da mostrare come anteprima. Il valore viene memorizzato così com'è; l'API non verifica che l'URL sia raggiungibile (verificato in test live), quindi invia un URL PDF valido e raggiungibile. Il valore predefinito è vuoto (nessun PDF di anteprima).

curl -X PUT 'https://go.fliplink.me/api/set-preview-pdf/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'PreviewPDF=https://go.fliplink.me/files/preview.pdf'

Risposta:

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

Impostare il PDF immagine

PUT /api/set-image-pdf/{flipbookId} imposta il PDF di sole immagini/anteprima usato per miniature e anteprime. Invia l'URL del PDF da usare come IMGPdf:

• IMGPdf — l'URL del PDF di sole immagini da usare per miniature e anteprime. Il valore viene memorizzato così com'è; l'API non verifica che l'URL sia raggiungibile (verificato in test live), quindi invia un URL PDF valido e raggiungibile. Il valore predefinito è un placeholder senza immagine, e inviare un valore vuoto mantiene il PDF immagine esistente.

curl -X PUT 'https://go.fliplink.me/api/set-image-pdf/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IMGPdf=https://go.fliplink.me/files/pages.pdf'

Risposta:

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

Errori possibili

• Chiave API mancante o non valida → HTTP 401. Restituisce una semplice pagina HTML di Unauthorized — non c'è alcun body JSON. Controlla che l'header X-Api-Key (o Authorization: Bearer) sia presente e corretto.
• 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: ….

Note

• Per entrambi i campi, il valore dell'URL viene memorizzato così com'è — l'API non verifica che il PDF sia raggiungibile (verificato in test live). Invia sempre un URL PDF valido e raggiungibile.
• Il PDF di anteprima (PreviewPDF) è vuoto per impostazione predefinita e viene azzerato automaticamente se sia la cattura lead sia la modalità di vendita sono disattivate.
• Il PDF immagine (IMGPdf) ha come valore predefinito un placeholder senza immagine; inviare un valore vuoto mantiene il PDF immagine esistente.