Voorkom dubbele e-mails met idempotency

Met de nieuwe idempotency functie in Lettermint voorkom je dat ontvangers e-mails dubbel ontvangen. Met een idempotency key weet je zeker dat een e-mail eenmalig wordt verstuurd, zelfs als er meerdere verzendpogingen worden gedaan via API, SMTP of andere integraties.

Wat is idempotency?

Idempotency is een term die vaak voorkomt in de wereld van softwareontwikkeling. Het houdt in dat een bewerking altijd hetzelfde resultaat oplevert, ongeacht hoe vaak deze wordt uitgevoerd. In het geval van e-mails zorgt idempotency ervoor dat dezelfde e-mail niet meerdere keren naar dezelfde ontvanger wordt gestuurd.

Stel je voor dat er een netwerkprobleem optreedt of dat een functie binnen een applicatie per ongeluk dubbel draait. Met idempotency voorkom je dubbele e-mails.

Wanneer gebruik je idempotency?

Idempotency is nuttig in situaties waarbij je wilt voorkomen dat dezelfde actie meerdere keren wordt uitgevoerd, zoals:

• Gebruikersfouten: Zorgt ervoor dat klikken op een knop slechts één e-mail stuurt.
• Serverproblemen: Voorkomt dubbele e-mails bij serverfouten.
• Netwerkproblemen: Voorkomt dubbele e-mails bij storingen.

Het is dus geen probleem om alle e-mails standaard met idempotency te versturen. Dit is vooral handig bij transactionele e-mails met belangrijke informatie.

Hoe werkt idempotency in Lettermint?

Idempotency is beschikbaar in veel van onze integraties, zoals PHP, Laravel, Node.js en via onze SMTP en API. Dit maakt het eenvoudig om idempotency toe te passen en te zorgen dat e-mails zonder duplicaten worden verzonden.

Als voorbeeld hieronder zie je hoe je deze functie gebruikt in onze PHP SDK:

          $lettermint = new Lettermint\Lettermint('your-api-token');

$lettermint->email
    ->from('John Doe <john@yourdomain.com>')
    ->to('recipient@example.com')
    ->subject('Hello from Lettermint!')
    ->text('Hello! This is a test email.')
    ->idempotencyKey('123e4567-e89b-12d3-a456-426614174000')
    ->send();

        

In dit voorbeeld wordt de idempotencyKey gebruikt om ervoor te zorgen dat de e-mail slechts één keer wordt verzonden, zelfs als de send() functie meerdere keren wordt aangeroepen met dezelfde key.

Wil je meer weten over idempotency en voorbeelden zien van andere integraties zoals Node.js, SMTP of API? Bekijk dan onze documentatie.