Proteggere un flipbook con password

Controllo degli accessi

Attiva o disattiva la protezione con password di un flipbook e personalizza la schermata della password — il titolo, il placeholder del campo e il pulsante — con un'unica chiamata API.

API usate in questa discussione

PUTSet Password Access/api/set-password-access/{flipbookId}

C'è qualcosa di inesatto o non aggiornato in questa guida?

Cosa puoi fare

La protezione con password mette una barriera davanti a un flipbook: i lettori devono inserire la password corretta prima che il contenuto venga caricato. Con una sola chiamata API puoi:

Attivare la protezione e impostare la password di accesso.
Disattivare la protezione di nuovo.
Personalizzare la schermata della password — il titolo, il placeholder del campo e l'etichetta del pulsante.

Prima di iniziare

Ti serviranno:

Una chiave API — inviata come header X-Api-Key in ogni richiesta.
Il flipbookId — l'id numerico restituito quando crei un flipbook (come ID) o dagli endpoint di elenco.
Le richieste vanno all'URL di base https://go.fliplink.me.

Il body è form-urlencoded (non JSON).

Parametri

Invia questi campi urlencoded su PUT /api/set-password-access/{flipbookId}:

Campo	Tipo	Cosa fa
`IsPasswordProtected`	boolean	`true` attiva la barriera della password; `false` la disattiva
`Password`	text	La password di accesso che i lettori devono inserire
`PwdTitle`	text	Titolo mostrato nella schermata della password (facoltativo)
`PwdPlaceholder`	text	Testo placeholder all'interno del campo password (facoltativo)
`PwdButton`	text	Etichetta del pulsante di invio (facoltativo)

Attivare la protezione con password

Imposta IsPasswordProtected=true e fornisci la Password. I tre campi Pwd* sono facoltativi — includili per personalizzare ciò che vede il lettore.

curl -X PUT 'https://go.fliplink.me/api/set-password-access/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsPasswordProtected=true' \
  --data-urlencode 'Password=spring-2026' \
  --data-urlencode 'PwdTitle=Enter the access code' \
  --data-urlencode 'PwdPlaceholder=Access code' \
  --data-urlencode 'PwdButton=View document'

Risposta:

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

Disattivare la protezione con password

Imposta IsPasswordProtected=false. Puoi lasciare vuoti gli altri campi.

curl -X PUT 'https://go.fliplink.me/api/set-password-access/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsPasswordProtected=false' \
  --data-urlencode 'Password=' \
  --data-urlencode 'PwdTitle=' \
  --data-urlencode 'PwdPlaceholder=' \
  --data-urlencode 'PwdButton='

Risposta:

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

Personalizzare la schermata della password

I campi PwdTitle, PwdPlaceholder e PwdButton ti permettono di adattare la barriera al tuo pubblico — per esempio, chiamandola "codice di accesso" per un portale clienti, o allineandola al tono del tuo brand. Sono facoltativi; omettili (o inviali vuoti) per usare i valori predefiniti.

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 sia presente e corretto.
flipbookId sconosciuto (o non di proprietà della tua chiave) → HTTP 200 con { "Result": "ERROR", "Message": "Item not found" }.
Campo del body scritto male → HTTP 200 con { "Result": "ERROR", "Message": "Unknown field(s) '…'. Expected: …" }. Ricontrolla i nomi dei campi con la tabella qui sopra.

Note

Condividi la password su un canale separato. Invia il link del flipbook e la password attraverso canali diversi — una password inclusa nella stessa email del link offre poca protezione.
La protezione con password è un solo livello. Controlla l'ingresso, non chi è il lettore. Per limitare l'accesso a persone indicate, abbinala a un elenco email consentite; per limitarlo nel tempo, affiancala alla scadenza del link.

Discussioni correlate

Gestire l'elenco email consentite di un flipbook Controllare l'indicizzazione sui motori di ricerca (noindex)