Envío de emails via API REST
¿Qué es?
Esta API REST permite el envío de emails a tu propia dirección mediante una llamada URL, tanto GET como POST.
Ésto permite una muy sencilla integración con cualquier microcontrolador con capacidad de red, como los ESP.
Para usar ésta función has de tener usuario registrado en esta sección de la web y tener tu correo validado.
El envío de correos se realiza usando el servidor de la web, que está validado por los estándares SPF, DKIM y DMARC, para que los correos lleguen de manera rápida y fiable a la bandeja de entrada y no sean marcados como SPAM.
¿Cómo se usa?
Primero has de crear una Aplicación. Para ello se requieren 2 campos: Nombre y email. Tras ello obtienes una ApiKey.
Tras ello puedes usar la API con tu ApiKey o identificarte en la web para visualizar los datos usando tu ApiKey y tu email.
Puedes crear tantas aplicaciones quieras con el mismo email, cada una tendrá una ApiKey diferente.
Puedes modificar tu email o el nombre de la Aplicación que tu ApiKey no cambiará.
Además, se tiene pensado usar el email para poder establecer alertas, en el futuro.
Llamada HTTP para enviar un email:
URL:
http://www.foroelectro.net/arduino/api/<ApiKey>/mail/mailme
Parámetros:
Todos los parámetros pueden ser pasados con cualquier método (GET, POST, etc).
- subject - Asunto del correo. Detrás se añadirá, automáticamente, " - ForoElectro.net"
- html - Opcional. Si añades este parámetro y lo pones a 1 se configurará el correo como HTML en lugar de texto sencillo.
- body - Contenido del correo electrónico.
Retorno:
Retorna un código numérico en modo texto:
- 1 - Todo ha funcionado correctamente.
- 0 - Error de autentificación; revisa tus credenciales y que tu correo esté validado.