Bloquez les mauvaises adresses dès le formulaire d'inscription
Vérifiez une adresse ou une liste entière avec l'API REST. Le widget de formulaire signale les adresses risquées au moment de l'inscription.
Une requête, une réponse claire
Même vérification et même réserve de crédits que l'application web. Ce que vous voyez à l'écran, l'API le renvoie.
Vérification uniqueEnvoyez une adresse, recevez son statut, son score et ses détails de risque en JSON.
Protection de formulaireUn script d'une ligne s'ajoute à votre formulaire. Il avertit quand une adresse risquée est saisie.
Listes et webhooksCréez une liste à partir d'un tableau JSON. Un webhook signé vous prévient à la fin de la tâche.
Clé sandboxTestez chaque statut avec des adresses de test. Aucun crédit consommé, aucune vraie adresse approuvée.
Avec la clé de production, chaque vérification coûte 1 crédit.
Gardez les mauvaises adresses hors de votre base
Une adresse mal saisie ou jetable qui s'inscrit une fois rebondit ensuite à chaque campagne. Repérez-la dans le formulaire et vous n'aurez pas à nettoyer la liste plus tard.
Envoyez deux fois la même requête avec une Idempotency-Key et vous récupérez la première réponse. Si un résultat tarde, l'API n'invente jamais de statut : elle vous dit où attendre.
Questions fréquentes
Chaque clé a une limite par minute ; la documentation indique la valeur actuelle. Au-delà, vous recevez un 429 avec un en-tête Retry-After.
Chaque vérification via l'API prend 1 crédit dans la même réserve que l'application web. La clé sandbox ne consomme aucun crédit.
Si le serveur de messagerie répond lentement, l'API renvoie 202 et vous indique où suivre le statut de la liste.
Chaque requête contient une signature HMAC dans l'en-tête X-Clearlist-Signature. Vérifiez-la avec votre secret et rejetez les requêtes de plus de 5 minutes.
Obtenez votre clé API
Connectez-vous et créez une clé dans Paramètres. Vos 100 premiers crédits sont offerts.