Guia de infraestrutura de e-mail
API de e-mail com Node.js
Um padrão no lado do servidor para enviar e-mails transacionais com Node.js sem vazar chaves de API.
Aplicações Node.js devem manter o envio de e-mails atrás de um módulo no servidor ou de um worker de jobs. O módulo recebe uma requisição de mensagem validada, chama a API de e-mail e persiste a resposta do provedor para fins de observabilidade.
O que isso significa na prática
- Credenciais de API somente no servidor
- Validação de entrada antes dos envios
- Política de timeout e de novas tentativas
- Identificadores de mensagem armazenados para suporte e auditoria
Checklist de implementação
- Leia a chave de API de uma variável de ambiente do servidor.
- Valide os campos de remetente, destinatário, assunto e conteúdo.
- Chame a API de e-mail a partir de um módulo de serviço ou de um worker de fila.
- Armazene o ID de mensagem retornado junto com o evento do produto.
- Tente novamente apenas as falhas sabidamente transitórias.
Perguntas que as equipes fazem
Posso chamar uma API de e-mail a partir de JavaScript no navegador?
Não exponha uma chave de API de envio no código do navegador. Envie pelo seu backend Node.js.
O envio de e-mail deve bloquear uma requisição web?
Em ações críticas, pode bloquear, mas filas costumam ser melhores para novas tentativas e resiliência.