POST au point de terminaison de vérification
Envoyez la demande à https://api.listcleaner.net/verify_email. Utilisez HTTPS et un corps de requête JSON.
Python Guide des API
Vérifiez les adresses e-mail avec Python.
Envoyez une requête JSON sécurisée avec requests, authentifiez-vous avec l'e-mail de votre compte et la clé API, et utilisez le statut renvoyé directement dans votre application.
Avant de commencer
Une requête Python complète comporte quatre parties.
L'exemple utilise Python 3 with the requests package. Stockez les informations d'identification dans les variables d'environnement côté serveur et remplacez l'adresse que vous devez vérifier.
Envoyer les deux en-têtes d'informations d'identification
Ajouter X-User-Email et X-Api-Key sur le serveur. N'exposez jamais une clé API privée dans le navigateur public JavaScript.
Fournissez une adresse e-mail
Encodez l'adresse au format JSON à l'aide du email propriété. Laissez la bibliothèque JSON du langage échapper correctement à la valeur.
Lire le code HTTP et l'état JSON
Une réponse réussie comprend success, request_id, email et status. Gérez les erreurs avant de faire confiance à ces champs.
Demande complète
Copiez l'exemple Python.
La requête copiée inclut le nom d'utilisateur et les en-têtes de clé API. Remplacez les exemples de valeurs par une configuration côté serveur en production.
Utilisez la réponse
Traitez séparément les résultats du transport, de l’API et de la vérification.
Un succès HTTP signifie que l'API a traité la demande. Le status décrit le résultat de l'adresse. Les pannes de réseau, les délais d'attente, les erreurs d'authentification et les crédits insuffisants nécessitent un traitement différent d'une adresse non livrable.
- Vérifiez l'état HTTP. Analysez JSON uniquement lorsqu'un corps de réponse est disponible.
- Vérifier
success. En cas d'erreur API, enregistrez l'ID de la demande et utilisez le comportement d'erreur documenté. - Utilisez le statut de vérification. Mappez les statuts ListCleaner à une politique produit explicite au lieu de supposer que chaque résultat non OK est identique.
- Conservez l’ID de la demande. Il fournit une référence sécurisée pour les journaux et le support sans exposer les informations d'identification.
Exemple de réponse réussie
{
"success": true,
"request_id": "7ad81f...",
"email": "customer@example.com",
"status": "OK"
}La réponse du public reste concise. Votre candidature décide si un statut particulier doit être accepté, examiné ou rejeté.
Liste de contrôle de production
Rendre l’intégration sûre et prévisible.
Protéger les informations d'identification
Chargez l'e-mail de l'utilisateur et la clé API à partir de l'environnement ou de la configuration secrète. Ne les confiez pas au contrôle de source, ne les enregistrez pas et ne les renvoyez pas à un navigateur.
Définir des délais d'attente raisonnables
Utilisez les délais d'attente de connexion et de demande totale. Traitez un délai d'attente de transport comme un résultat indisponible, et non comme une preuve que l'adresse soumise n'est pas valide.
Connectez-vous en toute sécurité
Enregistrez l'ID de la demande, le code HTTP, la durée et le statut final. Évitez le stockage inutile d’informations d’identification brutes ou d’ensembles de données personnelles complets.
FAQ Python
Questions d'intégration courantes.
Utilisez la documentation interactive pour les champs de requête faisant autorité et la console de test en direct.
Où dois-je stocker la clé API ListCleaner?
Stockez-le dans un environnement côté serveur ou une configuration secrète. Ne l'intégrez jamais dans un JavaScript public, un ensemble d'applications mobiles ou un fichier source validé.
La vérification unique envoie-t-elle un e-mail à l'adresse?
Non. Le point de terminaison renvoie son état technique sans envoyer de message de vérification au destinataire.
Dois-je bloquer tous les résultats qui ne sont pas corrects?
Non. Les résultats fourre-tout, temporaires et incertains nécessitent une politique documentée. Réservez le rejet définitif aux statuts qui fournissent des preuves suffisamment solides pour votre cas d’utilisation.
Puis-je nettoyer des fichiers complets de Python?
Oui. L'API prend également en charge les workflows de liste asynchrones: téléchargez un fichier pris en charge, conservez l'identifiant de la tâche, interrogez son statut et téléchargez le résultat final.
Autres langues