Intégrer Roucoule sur ton site#

Roucoule n'héberge pas de page d'inscription : tu places un formulaire sur ton site, qui envoie les inscriptions à l'API Roucoule.

1. Récupérer ton snippet#

Dans l'admin Roucoule, ouvre ton feed → onglet Intégration. Tu y trouves un bloc HTML/JS pré-rempli avec :

• l'identifiant de ton feed (feed_…) ;
• la clé publique du feed (rck_…) ;
• l'URL de l'API.

Clique sur Copier le code.

2. Coller le formulaire#

Colle le snippet dans une page de ton site (par exemple /abonnement). Il contient :

• un champ email et une case de consentement ;
• un champ caché website — c'est un honeypot anti-bot, ne le retire pas ;
• un script qui envoie l'inscription en AJAX et affiche un message.

3. Déclarer l'origine (CORS)#

Dans l'onglet Réglages du feed, ajoute l'URL de ton site (une par ligne) dans Origines autorisées. Sans cela, le navigateur bloquera la requête.

4. Tester#

Ouvre ta page, saisis un email, valide. L'abonné apparaît dans l'onglet Abonnés de l'admin.

Anti-abus#

• Rate limiting : 5 inscriptions/min et 30/heure par IP.
• Honeypot : si le champ website est rempli, la requête est ignorée.
• Captcha (optionnel) : active hCaptcha ou Turnstile dans les réglages.

Double opt-in#

Roucoule fait du single opt-in. Si tu veux un double opt-in, gère-le sur ton site : envoie ton propre email de confirmation, puis appelle l'API Roucoule au moment du clic de validation.

RGPD#

Ton formulaire doit afficher une case de consentement claire, et ta politique de confidentialité doit mentionner Roucoule comme sous-traitant.