Guida all'infrastruttura email
API email con Node.js
Un pattern lato server per inviare email transazionali da Node.js senza esporre le chiavi API.
Le applicazioni Node.js dovrebbero gestire l'invio delle email in un modulo lato server o in un worker di job. Il modulo riceve una richiesta di messaggio già validata, chiama l'API email e salva la risposta del provider per garantire l'osservabilità.
Cosa significa in pratica
- Credenziali API solo lato server
- Validazione dell'input prima dell'invio
- Policy di timeout e di nuovi tentativi
- Identificatori dei messaggi salvati per supporto e audit
Checklist di implementazione
- Leggi la chiave API da una variabile d'ambiente del server.
- Valida i campi mittente, destinatario, oggetto e contenuto.
- Chiama l'API email da un modulo di servizio o da un worker della coda.
- Salva l'ID del messaggio restituito insieme all'evento di prodotto.
- Ritenta solo gli errori di cui è nota la natura temporanea.
Le domande dei team
Posso chiamare un'API email da JavaScript nel browser?
Non esporre una chiave API di invio nel codice del browser. Invia invece tramite il tuo backend Node.js.
L'invio di un'email deve bloccare una richiesta web?
Per le azioni critiche può farlo, ma spesso le code sono una scelta migliore per i nuovi tentativi e la resilienza.