Prévenir les emails dupliqués avec idempotency

Avec la nouvelle fonctionnalité idempotency de Lettermint, vous pouvez empêcher les destinataires de recevoir des emails dupliqués. Avec une idempotency key, vous pouvez vous assurer qu'un email est envoyé une seule fois, même si plusieurs tentatives d'envoi sont effectuées via API, SMTP ou d'autres intégrations.

Qu'est-ce que l'idempotency ?

Idempotency est un terme souvent utilisé dans le monde du développement logiciel. Il signifie qu'une opération produit toujours le même résultat, peu importe combien de fois elle est exécutée. Dans le cas des emails, idempotency garantit que le même email n'est pas envoyé plusieurs fois au même destinataire.

Imaginez qu'un problème de réseau survienne ou qu'une fonction au sein d'une application s'exécute accidentellement deux fois. Avec idempotency, vous pouvez empêcher les emails dupliqués.

Quand utiliser l'idempotency ?

Idempotency est utile dans des situations où vous souhaitez empêcher qu'une même action soit effectuée plusieurs fois, comme :

• Erreurs utilisateur : Assure que cliquer sur un bouton n'envoie qu'un seul email.
• Problèmes de serveur : Empêche les emails dupliqués en cas d'erreurs serveur.
• Problèmes de réseau : Empêche les emails dupliqués lors de pannes.

Il n'y a donc aucun problème à envoyer tous les emails avec idempotency par défaut. Cela est particulièrement utile pour les transactional emails contenant des informations importantes.

Comment fonctionne l'idempotency dans Lettermint ?

Idempotency est disponible dans bon nombre de nos intégrations, telles que PHP, Laravel, Node.js et via notre SMTP et API. Cela facilite l'application de l'idempotency et garantit que les emails sont envoyés sans duplicata.

Voici un exemple de la façon d'utiliser cette fonctionnalité dans notre SDK PHP :

          $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();

        

Dans cet exemple, le idempotencyKey est utilisé pour s'assurer que l'email est envoyé une seule fois, même si la fonction send() est appelée plusieurs fois avec la même key.

Vous voulez en savoir plus sur l'idempotency et voir des exemples d'autres intégrations comme Node.js, SMTP ou API ? Consultez notre documentation.