Service pour vérifier si un est actif. Vérifiez les courriers de vos bases

Transcription

1 MailStatus API Service pour vérifier si un est actif. Vérifiez les courriers de vos bases Aspects généraux de données. La MailStatus API de Lleida.net permet de vérifier la validité d'une adresse de courrier électronique. L'URL de l'api est: Pour vérifier la validité d'une adresse de courrier électronique, il faut suivre les pas suivants: Regular Expression Check Vérification du format de l'adresse. DNS Check Vérification des registres MX du domaine. Blacklisted Check Vérification du domaine (s'il a activé le mode blacklist). Greylisted Check Vérification du domaine (s'il a activé le mode greylist). SMTP Check Vérification de l'utilisateur à travers une connexion SMTP. Catch-all Check Vérification du domaine (s'il a activé le mode catch-all). Dans les exemples de cette documentation l'on utilise le symbole {:name} pour votre nom d'utilisateur et {:pass} pour votre mot de passe. Toutes les opérations exigent les paramètres suivants: user. Nom d'utilisateur de Lleida.net password. Mot de passe d'utilisateur de Lleida.net . Adresse de courrier électronique request. Optionnel. Type de requête. Nous en recommandons l'utilisation malgré le fait d'être optionnel. request_id. Optionnel. Identifiant de la requête Nous en recommandons l'utilisation malgré le fait d'être optionnel. Les paramètres d'entrée peuvent être encapsulés dans un document XL ou JSON. Ce document doit continuer en format défini en mailstatus.dtd ( Requêtes en format XML GET HTTP/1.1

2 POST HTTP/1.1 xml={:mailstatus_xml} Content-type: application/x-www-form-urlencoded Requêtes en format JSON GET HTTP/1.1 POST HTTP/1.1 json={:mailstatus_json} Content-type: application/x-www-form-urlencoded Requêtes avec des variables Une autre alternative est d'envoyer les paramètres comme tuples clé: valeur La réponse peut être configurée en format XML ou JSON. GET HTTP/1.1 POST HTTP/1.1 user={:name}&password={:pass}&... Content-type: application/x-www-form-urlencoded Allons-y!! Format de réponse Toutes les opérations reçoivent comme réponse un autre document XML ou JSON dont le nœud principal est l'élément response. Cet élément se compose de plusieurs éléments (toujours présents) communs à toutes les opérations, suivis d'autres éléments spécifiques pour l'opération demandée. Les éléments communs de l'élément response sont les suivants: code Est le code d'état informatif du succès ou de l'échec de l'opération.

3 status Est la description du code d'état. request Contient un nom identificateur de l'opération appelée. Les réponses respectent la spécification de la DTD mailstatus_response.dtd ( Pour obtenir comme réponse un document XML vous pouvez ajouter l'entête HTTP: Pour obtenir un document JSON: Codes d'état Status Description 200 Success 1400 Method not allowed 1401 Invalid request 1402 Invalid content 1403 No data found 1404 Invalid XML 1405 Invalid JSON 1500 Unknown error 1501 Timeout error 1502 Connection error Status Description Codes de réponse

4 SMTP Description 111 Connection refused 250 Requested mail action okay, completed 251 User not local; will forward to forward-path 421 Timeout exceeded or service not available, closing transmission channel 442 The connection was dropped during the transmission. 450 Requested mail action not taken: mailbox unavailable 451 Requested action aborted: local error in processing 452 Requested action not taken: insufficient system storage 471 An error of your mail server 500 Syntax error, command unrecognised 501 Syntax error in parameters or arguments 503 Bad sequence of commands 510 Bad address 512 The host server for recipient's domain name cannot be found 521 Domain does not accept mail [rfc1846] 550 Requested action not taken: mailbox unavailable 551 User not local; please try forward-path 552 Requested mail action aborted: exceeded storage allocation 553 Requested action not taken: mailbox name not allowed 554 This means that the transaction has failed. It's a permanent error. SMTP Description MailStatus Obtenir informations d'un courrier électronique.

5 GET HTTP/1.1 Paramètres user Nom d'utilisateur de Lleida.net password Mot de passe d'utilisateur de Lleida.net request Optionnel. check . request_id Optionnel. Identifiant de la requête Adresse de courrier Exemple de requête GET Réponse <?xml version="1.0" encoding="iso "?> <!DOCTYPE response SYSTEM "mailstatus_response.dtd"> <response> <request>check </request> <code>200</code> <status>success</status> <valid/> <detail> <regexp>1</regexp> <dns> <domain>gmail.com</domain> <mx preference="30">alt3.gmail-smtp-in.l.google.com</mx> <mx preference="40">alt4.gmail-smtp-in.l.google.com</mx> <mx preference="5">gmail-smtp-in.l.google.com</mx> <mx preference="10">alt1.gmail-smtp-in.l.google.com</mx> <mx preference="20">alt2.gmail-smtp-in.l.google.com</mx> <mx preference="5">gmail-smtp-in.l.google.com</mx> <mx preference="10">alt1.gmail-smtp-in.l.google.com</mx> <mx preference="20">alt2.gmail-smtp-in.l.google.com</mx> <mx preference="30">alt3.gmail-smtp-in.l.google.com</mx> <mx preference="40">alt4.gmail-smtp-in.l.google.com</mx> <spf>v=spf1 redirect=_spf.google.com v=spf1 redirect=_spf.google.com</spf> </dns> <smtp>250</smtp> <blacklist>0</blacklist> <greylist>0</greylist> <catchall>0</catchall>

6 </detail> </response>