API de leads
Aussi appelé : lead api, api prospects, integration api leads, flux api lead · En anglais : lead API
Une API de leads permet à des systèmes d'envoyer, recevoir ou mettre à jour des contacts commerciaux selon un contrat technique. Elle définit les champs, formats, authentification, réponses, erreurs et règles de sécurité. Une intégration fiable conserve les identifiants, la source, les preuves et l'idempotence afin qu'une reprise ne crée pas de doublon.
Définition
Le schéma distingue champs obligatoires, facultatifs et conditionnels. Les types, listes de valeurs, fuseaux et versions sont documentés avec des exemples valides et invalides.
L'authentification identifie l'appelant ; l'autorisation limite les campagnes et opérations. Les secrets ne sont pas placés dans des URL ou journaux accessibles.
L'idempotence permet de renvoyer une requête après un incident sans recréer ni refacturer le lead. La réponse renvoie un identifiant, un statut et des erreurs exploitables champ par champ.
La supervision suit latence, rejets, taux d'erreur et files de reprise. La donnée commerciale et la preuve doivent rester cohérentes pendant toute la chaîne.
Concrètement
Exemple : le fournisseur envoie un lead avec un identifiant unique. L'API répond “accepté”, “rejeté : zone” ou “en qualification”. Si la connexion coupe après réception, la même clé renvoyée retourne le résultat initial au lieu de créer un second lead.
À ne pas confondre avec
| Interface | Direction | Usage |
|---|---|---|
| API | Requête et réponse | Créer ou consulter |
| Webhook | Serveur vers destinataire | Notifier |
| Fichier | Lot | Import différé |
| Formulaire | Utilisateur vers système | Collecte |
Cadre juridique
L'API doit appliquer sécurité, minimisation, contrôle d'accès, journalisation appropriée et durées. Les logs ne doivent pas devenir une copie indéfinie de toutes les données personnelles.
Ce que l'on nous demande sur ce terme
Quels champs essentiels ?
Pourquoi l'idempotence ?
Comment gérer les erreurs ?
API ou webhook ?
Comment versionner ?
Appliqué à Prospect.fr
Le Format Lead Ouvert 1.0 fournit à Prospect.fr une structure versionnée réutilisable dans les API et intégrations.
Rédigé par Rédaction Prospect.fr · Dernière revue le
Des leads conformes, avec la preuve livrée
Consentement horodaté, enregistrement de l'appel de qualification et source tracée sont rattachés à chaque lead livré sur Prospect.fr.