Confidentialité des prospects et vérification des e-mails

Ce que tu peux faire

Quand un flipbook capture des prospects, tu peux façonner deux aspects de cette expérience via l'API :

• Confidentialité / consentement — configure le texte et les options de confidentialité/consentement de la capture de prospects (par exemple, la case de consentement RGPD), y compris un lien vers ta politique de confidentialité.
• Vérification des e-mails — active ou désactive la vérification de l'e-mail des prospects, obligeant les lecteurs à confirmer leur e-mail avant d'accéder au contenu.

Avant de commencer

Il te faut :

• Une clé d'API — envoyée soit dans l'en-tête X-Api-Key, soit sous la forme Authorization: Bearer YOUR_API_KEY à chaque requête.
• L'{flipbookId} — l'ID numérique du flipbook/document. Il est renvoyé par create-by-file / create-by-url (sous la forme ID) ou par list. Les deux endpoints le prennent comme paramètre de chemin.
• Toutes les requêtes vont vers l'URL de base https://go.fliplink.me.

Le corps de requête des deux endpoints est form-urlencoded (pas du JSON).

Configurer la confidentialité et le consentement

PUT /api/set-lead-privacy/{flipbookId} configure le texte et les options de confidentialité/consentement de la capture de prospects (par exemple la case de consentement RGPD).

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

Réponse :

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

Configurer la vérification des e-mails

PUT /api/set-lead-verification/{flipbookId} active ou désactive la vérification de l'e-mail des prospects, obligeant les lecteurs à confirmer leur e-mail avant d'accéder au contenu.

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

Réponse :

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

Erreurs possibles

• Clé d'API manquante ou invalide → HTTP 401. Cela renvoie une simple page HTML « Unauthorized » — il n'y a pas de corps JSON. Vérifie que l'en-tête X-Api-Key est présent et correct.
• ID d'élément introuvable ou non détenu par ta clé → HTTP 200 avec Message Item not found.
• Champ de corps inconnu ou mal orthographié → HTTP 200 avec Message Unknown field(s) '…'. Expected: ….

Remarques

• Le champ TwillioAPIKey conserve l'orthographe d'origine Twillio — envoie-le sous ce nom exact.