API para envio de Emails 📬

O objetivo é permitir que outras aplicações possam enviar emails através de uma rest-api.

Como instalar o projeto 🔨

Clone o projeto em alguma pasta

git clone https://github.com/pedroFnseca/SendMail-API.git

Entre na pasta

cd SendMail-API

Instale as dependências

npm install

Configurações 🔧

Crie um arquivo na raiz do projeto com o nome .env

Entre no arquivo e adicione as informações necessárias para o funcionamento do projeto

EMAIL_USER="[email protected]"
EMAIL_PWD_APP="senha-app"

Nota importante 📝⚠️

A senha da aplicação é gerada pelo servidor de email e não pode ser alterada.

Caso use um email @gmail neste link tem o passo a passo para configurar o email: https://support.google.com/accounts/answer/185833?hl=pt-BR

Salve o arquivo e inice o projeto 🚀

node src/index.js

Como usar o projeto 📝

Métodos disponíveis

Método	Descrição
POST	Envia um email
GET	Retorna a lista de emails enviados

OBS: O método GET está em desenvolvimento 🔥

URL (POST): http://localhost:4652/send/text

{
    "to": "[email protected]",
    "subject": "Assunto do email",
    "text": "Envio de texto simples"
}

URL (POST): http://localhost:4652/send/html

{
    "to": "[email protected]",
    "subject": "Assunto do email",
    "html": "<h1>Envio de html</h1>"
}

Códigos 💥

500 Verifique se o email e a senha estão corretos.

422 verifique se o formato do json está correto.

404 verifique se o endpoint e método está correto.

200 enviado com sucesso.

Como acoplar o projeto 🔌

⚠️ Nota importante: Para o acoplamento funcionar corretamente é necessário que o projeto esteja rodando em um servidor (local ou heroku por exemplo).

⚠️ Atenção: Cuidado para não utilizar a mesma porta que o projeto está rodando 4652.

Crie um arquivo em sua pasta services com o nome 'sendmail.js' (ou outro nome)

E coloque o seguinte código:

import axios from "axios"
import { config } from "dotenv"

config() // Carrega as variáveis de ambiente do .env

// Cria uma instância do axios
const api = axios.create({
    baseURL: process.env.URL_SERVER_EMAIL = "http://localhost:4652" 
})

// Método para enviar e-mail
async function sendMail(data) {

    // Verifica se os dados foram passados corretamente
    if (!data.to || !data.subject || !data.html) {
        throw new Error('Data is not valid')
    }

    // Envia o e-mail
    await api.post('/send/html', {
        to: data.to,
        subject: data.subject,
        html: data.html,
    })

    // Retorna o resultado
    return true
}

// Exporta o método sendMail
export default sendMail

Nota importante 📝⚠️

O projeto deve possuir o axios e o dotenv instalados.

Para chamar a função

import sendMail from 'caminho/services/SendMail.js'

await sendMail({
    to: '[email protected]',
    subject: 'Assunto do email',
    html: '<h1>Mensagem para o usuário</h1>'
})

console.log('E-mail enviado com sucesso 🚀')

Caso use o projeto 📝

Cite o projeto em seu README 😁

Caso encontre bugs ou erros, reporte no github 😞

Caso queira contribuir com o projeto, faça um pull request 🚀

Nota 📝⚠️

O projeto já está configurado para ser hospedado no heroku, e caso queira hospedar, somente altere as váriaveis de ambiente.

Obrigado por ler sobre o projeto 😊❤️