POST naar het verificatie-eindpunt
Stuur het verzoek naar https://api.listcleaner.net/verify_email. Gebruik HTTPS en een JSON-aanvraagtekst.
Python API-gids
Controleer e-mailadressen met Python.
Stuur een veilig JSON-verzoek met requests, authenticeer met het e-mailadres van uw account en API-sleutel, en gebruik de geretourneerde status rechtstreeks in uw applicatie.
Voordat je begint
Een compleet Python verzoek bestaat uit vier delen.
In het voorbeeld wordt Python 3 with the requests package gebruikt. Bewaar inloggegevens in omgevingsvariabelen aan de serverzijde en vervang het adres dat u moet verifiëren.
Verzend beide referentieheaders
Toevoegen X-User-Email en X-Api-Key op de server. Geef nooit een privé-API-sleutel vrij in de openbare browser JavaScript.
Geef één e-mailadres op
Codeer het adres als JSON met behulp van de email eigendom. Laat de JSON-bibliotheek van de taal de waarde correct ontsnappen.
Lees de HTTP-code en JSON-status
Een succesvolle reactie omvat success, request_id, email en status. Behandel fouten voordat u deze velden vertrouwt.
Volledige aanvraag
Kopieer het Python voorbeeld.
Het gekopieerde verzoek bevat de headers van de gebruikersnaam en de API-sleutel. Vervang de voorbeeldwaarden door configuratie aan de serverzijde in productie.
Gebruik het antwoord
Behandel transport-, API- en verificatieresultaten afzonderlijk.
Een HTTP-succes betekent dat de API het verzoek heeft verwerkt. De status beschrijft het adresresultaat. Netwerkstoringen, time-outs, authenticatiefouten en onvoldoende tegoed vereisen een andere afhandeling dan een onbestelbaar adres.
- Controleer de HTTP-status. Parseer JSON alleen als er een antwoordtekst beschikbaar is.
- Controleer
success. Noteer bij een API-fout de aanvraag-ID en gebruik het gedocumenteerde foutgedrag. - Gebruik de verificatiestatus. Wijs ListCleaner-statussen toe aan een expliciet productbeleid in plaats van aan te nemen dat elk niet-OK-resultaat identiek is.
- Bewaar de aanvraag-ID. Het biedt een veilige referentie voor logboeken en ondersteuning zonder inloggegevens vrij te geven.
Voorbeeld succesreactie
{
"success": true,
"request_id": "7ad81f...",
"email": "customer@example.com",
"status": "OK"
}De publieke reactie blijft beknopt. Uw aanvraag beslist of een bepaalde status moet worden geaccepteerd, beoordeeld of afgewezen.
Controlelijst voor productie
Maak de integratie veilig en voorspelbaar.
Bescherm referenties
Laad het e-mailadres en de API-sleutel van de gebruiker vanuit de omgeving of geheime configuratie. Leg ze niet vast aan broncontrole, log ze niet en stuur ze niet terug naar een browser.
Stel verstandige time-outs in
Gebruik time-outs voor verbindingen en totale aanvragen. Beschouw een transporttime-out als een onbeschikbaar resultaat en niet als bewijs dat het opgegeven adres ongeldig is.
Veilig inloggen
Leg de aanvraag-ID, HTTP-code, duur en eindstatus vast. Vermijd onnodige opslag van onbewerkte inloggegevens of volledige persoonlijke datasets.
Veelgestelde vragen over Python
Veel voorkomende integratievragen.
Gebruik de interactieve documentatie voor de gezaghebbende verzoekvelden en de live testconsole.
Waar moet ik de API-sleutel ListCleaner opslaan?
Bewaar het in een serveromgeving of in een geheime configuratie. Sluit het nooit in in openbare JavaScript, een mobiele applicatiebundel of een vastgelegd bronbestand.
Stuurt eenmalige verificatie een e-mail naar het adres?
Nee. Het eindpunt retourneert zijn technische status zonder een verificatiebericht naar de ontvanger te sturen.
Moet ik elk resultaat blokkeren dat niet in orde is?
Nee. Voor allesomvattende, tijdelijke en onzekere uitkomsten is gedocumenteerd beleid nodig. Reserveer harde afwijzing voor statussen die voldoende sterk bewijs leveren voor uw gebruiksscenario.
Kan ik volledige bestanden van Python opschonen?
Ja. De API ondersteunt ook asynchrone lijstworkflows: upload een ondersteund bestand, bewaar de taakidentificatie, controleer de status ervan en download het eindresultaat.
Andere talen