¿Cómo crear un API REST para el envío de mails con el FlowEngine?
En este tutorial vamos a crear una API REST desde el FlowEngine que nos servirá para enviar correos electrónicos.
En este caso la API la crearemos como administrador y será pública.
Seguiremos los siguientes pasos:
Seleccionamos la opción "FlowEngine Management" del menú:
Seleccionamos el dominio perteneciente a nuestro usuario administrador:
Una vez estamos dentro del dominio, arrastramos un nodo de tipo "OnesaitPlatform API REST" al flujo para crear la API. Rellenamos las propiedades, marcando el check de "is Public".
Ahora arrastraremos al flujo un nodo de tipo "OnesaitPlatform API REST operation", lo enlazaremos al nodo API anterior y rellenaremos las propiedades como mostramos a continuación:
Para este ejemplo, la información referente a destinatario, remitente, asunto y cuerpo del mensaje se pasarán como datos de una petición POST.
Una vez tenemos la operación definida vamos a preparar la lógica de envío de correo. Procesaremos los datos recibidos de la petición POST y los prepararemos para llamar a la API de MailGun. Todo esto lo haremos en un nodo de tipo "Function":
Una vez tenemos los datos de entrada listos, los vamos a pasar a un nodo de tipo "Http request". Con este nodo mandaremos la petición de envío de correo hacia MailGun. Siguiendo las directrices de la API de MailGun rellenaremos las propiedades como sigue:
Para acabar el flujo necesitamos devolver una respuesta a la llamada inicial de la operación. Para este ejemplo nos será suficiente con devolver lo que la API de MailGun nos retorna a nuestra petición. Arrastramos un nodo de tipo "OnesaitPlatform API REST operation response" y lo conectamos a la salida del nodo anterior:
Solamente nos falta desplegar los cambios para que la API se de de alta. Para ello hacemos click en el botón "deploy":
Llegados a este punto ya tenemos nuestra API creada y lista para usar como cualquier otra API de la plataforma: