Gids over e-mailinfrastructuur
E-mail versturen met een API
Een stapsgewijze aanpak voor geauthenticeerd e-mail versturen via een API, testen en veilig werken in productie.
Een e-mailrequest in productie heeft meer nodig dan een ontvanger en een onderwerp. Je hebt een geverifieerde afzender nodig, een template die bij het doel past, authenticatie, foutafhandeling en een manier om het resultaat te volgen.
Wat dit in de praktijk betekent
- Een geverifieerd From-domein
- Een API-sleutel die beperkt is tot de juiste workspace
- Gestructureerde HTML- en tekstcontent
- Een retrystrategie die dubbele bezorging voorkomt
Implementatiechecklist
- Maak een geverifieerd domein aan en kies een afzenderadres.
- Bewaar de API-sleutel in server-side omgevingsvariabelen.
- Stuur een testbericht naar een inbox die je zelf beheert.
- Log het respons-ID van de provider en handel niet-succesvolle responses af.
- Voeg een idempotentiesleutel of event-ID toe voor jobs die opnieuw worden geprobeerd.
Vragen die teams stellen
Mag je een API-sleutel in browsercode gebruiken?
Nee. Houd verzendcredentials op een server, worker of vertrouwde backend.
Hoe voorkom ik dat e-mails dubbel worden verstuurd?
Gebruik een stabiele event-identifier of idempotentiesleutel en sla het bericht-ID van de provider op voordat je mislukte jobs opnieuw probeert.