Privacy dei lead e verifica email

Cosa puoi fare

Quando un flipbook cattura lead, puoi modellare due parti di quell'esperienza tramite l'API:

• Privacy / consenso — configura il testo e le opzioni di privacy/consenso della cattura lead (per esempio, la casella di consenso GDPR), incluso un link alla tua informativa sulla privacy.
• Verifica email — attiva o disattiva la verifica email dei lead, richiedendo ai lettori di confermare la propria email prima dell'accesso.

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. Viene restituito da create-by-file / create-by-url (come ID) o da list. Entrambi gli endpoint lo accettano come parametro nel percorso.
• Tutte le richieste vanno all'URL di base https://go.fliplink.me.

Il body della richiesta per entrambi gli endpoint è form-urlencoded (non JSON).

Configurare privacy e consenso

PUT /api/set-lead-privacy/{flipbookId} configura il testo e le opzioni di privacy/consenso della cattura lead (per esempio la casella di consenso GDPR).

curl -X PUT 'https://go.fliplink.me/api/set-lead-privacy/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsLeadPrivacyPolicy=false' \
  --data-urlencode 'PrivacyPolicyURL=' \
  --data-urlencode 'PrivacyPolicyText='

Risposta:

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

Configurare la verifica email

PUT /api/set-lead-verification/{flipbookId} attiva o disattiva la verifica email dei lead, richiedendo ai lettori di confermare la propria email prima dell'accesso.

curl -X PUT 'https://go.fliplink.me/api/set-lead-verification/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsVerifyEmail=false' \
  --data-urlencode 'IsVerifyMobile=false' \
  --data-urlencode 'TwillioAPIKey=' \
  --data-urlencode 'EmailVerifyTitleText=' \
  --data-urlencode 'EmailVerifyButtonText='

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 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

• Il campo TwillioAPIKey mantiene l'ortografia originale Twillio — invialo con quel nome esatto.