Servicio para comprobar si un está operativo. Coteja los correos de tus bases de datos.

Transcripción

1 MailStatus API Servicio para comprobar si un está operativo. Coteja los correos de tus bases de datos. Aspectos generales La MailStatus API de Lleida.net permite consultar la validez de una dirección de correo electrónico. La URL de la API es: Para comprobar la validez de una dirección de correo electrónico se realizan los siguientes pasos: Regular Expression Check Se verifica el formato de la dirección. DNS Check Se verifican los registros MX del dominio. Blacklisted Check Se verifica si el dominio tiene activado el modo blacklist. Greylisted Check Se verifica si el dominio tiene activado el modo greylist. SMTP Check Se verifica el usuario mediante una conexión SMTP. Catch-all Check Se verifica si el dominio tiene activado el modo catch-all. En los ejemplos de esta documentación se usa el símbolo {:name} para tu nombre de usuario y {:pass} para tu contraseña. Todas las operaciones requieren de los siguientes parámetros: user. Nombre de usuario de Lleida.net. password. Contraseña del usuario de Lleida.net. . Dirección de correo. request. Opcional. Tipo de petición. Aunque sea opcional recomendamos su uso. request_id. Opcional. Identificador de la petición. Aunque sea opcional recomendamos su uso. Los parámetros de entrada pueden estar encapsulados dentro de un documento XML o JSON. Este documento debe seguir el formato definido en mailstatus.dtd ( Peticiones en formato XML GET HTTP/1.1

2 POST HTTP/1.1 xml={:mailstatus_xml} Content-type: application/x-www-form-urlencoded Peticiones en formato JSON GET HTTP/1.1 POST HTTP/1.1 json={:mailstatus_json} Content-type: application/x-www-form-urlencoded Peticiones con variables Otra alternativa es enviar los parámetros como tuplas clave:valor. La respuesta se puede configurar tanto en formato XML como JSON. GET HTTP/1.1 POST HTTP/1.1 user={:name}&password={:pass}&... Content-type: application/x-www-form-urlencoded Al turrón! Formato de respuesta Todas las operaciones reciben como respuesta un documento XML o JSON, cuyo nodo raíz es el elemento response. Éste se compone de varios elementos comunes y siempre presentes en todas las operaciones, seguidos de otros elementos específicos para la operación que se ha invocado. Los elementos comunes del elemento response son los siguientes: code Es el código de estado informativo del éxito o error de la operación.

3 status Es la descripción del código de estado. request Contiene un nombre identificativo de la operación que se ha invocado. Las respuestas cumplen con la especificación de la DTD mailstatus_response.dtd ( Para obtener como respuesta un documento XML puede añadir la cabecera HTTP: Para obtener un documento JSON: Códigos de estado Status Descripción 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 Descripción Códigos de respuesta

4 SMTP Descripción 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 Descripción MailStatus Obtener información de un correo electrónico.

5 GET HTTP/1.1 Parámetros user Nombre de usuario de Lleida.net. password Contraseña del usuario de Lleida.net. request Opcional. check . request_id Opcional. Identificador de la petición. Dirección de correo. Ejemplo de petición GET Respuesta <?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>