Documentation développeur · Spécification partenaire
Cette documentation décrit le flux d'intégration cible pour créer, faire signer, suivre et auditer un accord de consentement mutuel via widget, API REST ou parcours co-brandé. Elle sert de base de cadrage technique avant contractualisation.
Flux d'intégration
Consentr intervient comme couche de confiance entre votre produit, vos membres et vos équipes de conformité. Le contenu détaillé reste confidentiel; votre plateforme consomme surtout des statuts, des preuves et des événements.
3 modes d'intégration
Consentr fournit un composant embarquable dans votre app web ou mobile web. Il affiche le parcours de création/signature sans exposer vos utilisateurs à une rupture d'expérience.
Votre backend pilote la création d'accords, l'envoi des liens de signature et la récupération d'un statut horodaté. C'est le mode recommandé pour une intégration native mobile.
Consentr héberge le parcours avec vos éléments de marque et un badge « Safety by Consentr ». L'intégration est plus rapide, tout en restant présentable aux équipes Trust & Safety.
Snippet widget
Le widget reçoit une clé publique partenaire et un contexte non sensible. Les actions critiques restent confirmées côté serveur via clé API privée.
<script src="https://cdn.consentr.fr/widget/v1.js" async></script>
<div
id="consentr-widget"
data-public-key="pk_live_partner_xxxxxxxxx"
data-theme="dark"
data-locale="fr-FR"
data-partner-user-id="usr_123"
></div>
<script>
window.Consentr?.mount("#consentr-widget", {
agreementTemplate: "first_date_v1",
partnerAgreementId: "meet_9f8b2c",
onStatusChange: (event) => {
console.log("Consentr status", event.status);
}
});
</script>Authentification
Les appels API utilisent une clé privée transmise dans l'en-tête Authorization. Les clés publiques du widget ne permettent jamais de créer seules une preuve définitive.
curl -X POST https://api.consentr.fr/v1/agreements \
-H "Authorization: Bearer cstr_live_xxxxxxxxx" \
-H "Idempotency-Key: meet_9f8b2c" \
-H "Content-Type: application/json" \
-d @agreement.jsoncstr_test_ pour sandbox, cstr_live_ pour production.Idempotency-Key conseillé pour toute création d'accord.Endpoints REST envisagés
Les exemples ci-dessous décrivent le contrat d'API cible. Les noms de champs exacts peuvent être figés dans le contrat partenaire, mais le flux et les garanties restent ceux présentés ici.
Sécurité & RGPD
Consentr est pensé comme un sous-traitant de confiance : peu de données, des preuves techniques, une révocation visible et des durées de conservation contractualisées.
Données hébergées dans l'Union européenne, avec séparation logique par partenaire et journalisation des accès administratifs.
HTTPS obligatoire, chiffrement au repos des données sensibles et empreintes cryptographiques pour les événements de preuve.
Les identifiants partenaires remplacent les données personnelles dès que possible. Les champs libres sont limités et configurables par modèle.
Chaque partie conserve un lien de révocation. Toute révocation change immédiatement le statut et reste visible dans la preuve horodatée.
Chaque événement critique est horodaté, signé côté serveur et associé à une empreinte pour faciliter les revues Trust & Safety.
Export, suppression et limitation de conservation sont prévus dans le contrat de traitement avec chaque plateforme partenaire.
Prêt pour un cadrage technique ?
La prochaine étape consiste à choisir le mode d'intégration, valider le modèle de données minimal et ouvrir un environnement sandbox partenaire.