Emmanuel Boisgontier

Emmanuel Boisgontier

Nous vous avions présentée il y a quelques mois sa bêta, la voici aujourd’hui finalisée: découvrez Send API 3.1, la nouvelle version améliorée de notre Send API v3 !

Depuis maintenant trois ans, Send API assure le routage de vos emails transactionnels. Nous vous présentons sa toute dernière version spécialement développée pour optimiser encore davantage votre expérience d’envoi.

Après des mois de dur labeur et une bêta riche en feedbacks de la part de notre communauté de développeurs, nous avons le plaisir de vous annoncer que Send API 3.1 devient la version officielle et stable pour nos utilisateurs. Sortez le champagne !

Pas de panique, nous continuons d’assurer la prise en charge de Send API 3.0… mais nous vous encourageons à migrer vers cette nouvelle version optimisée !

Pourquoi cette nouvelle version ?

Il faut voir les choses en face : les développeurs adorent trouver des solutions et résoudre leurs problèmes de manière créative, mais ce qu’ils préfèrent au travail, c’est surtout quand tout fonctionne comme il faut. C’est particulièrement vrai pour les API, qui peuvent être très difficiles à gérer compte tenu du manque de documentation ou de clarté concernant les payloads attendus et renvoyés.

Pour vous faciliter la tâche, nous avons tout mis en œuvre pour vous proposer une expérience d’intégration de Send API sans complication. Notre documentation complète a été rédigée par des développeurs, pour les développeurs, tandis que la structure de nos payloads a été optimisée pour vous offrir une expérience fluide.

Cette version s’accompagne également d’une performance et d’une évolutivité améliorées : nous l’avons redéveloppée à partir de zéro. Autrefois basée sur Free Pascal, Send API repose maintenant sur une nouvelle stack technique combinant entre autres Golang, Cassandra et Kafka. Pas mal, non ?

Parfait ! Montrez-moi le code !

La première chose qui saute aux yeux avec cette nouvelle version, c’est la qualité de l’expérience d’intégration. Voyez plutôt :

Envoyer des messages

Que vous envoyiez un ou plusieurs messages, il vous suffit d’effectuer un seul appel HTTP sur la route /v3.1/send. Send API acceptera un payload en JSON avec le paramètre Messages, un tableau acceptant jusqu’à 100 messages. Facile, non ?

Payloads d’erreur et de succès plus détaillés

Grâce aux retours de notre communauté, nous avons considérablement amélioré nos payloads de réponse. Nous effectuons désormais des vérifications strictes sur vos payloads d’entrée, ce qui vous permet de recevoir des retours immédiats sur les problèmes potentiels. Ainsi, vous gagnez du temps sur la résolution des erreurs. De notre côté, nous recevons moins d’emails mal structurés. Consultez cet exemple de payload d’erreur.

Notez cependant que ces erreurs sont générées individuellement pour chaque message, et que seul le processus d’envoi des messages erronés sera bloqué.

Nos payloads de retours en cas de succès sont également plus détaillés. Ils sont par exemple dotés d’une propriété MessageHref, une URL qui pointe vers la route API appropriée pour la récupération des métadonnées du message. Il n’a jamais été aussi facile de suivre vos emails dès leur envoi.

Les payloads de succès et d’erreur sont désormais envoyés simultanément, dans le même ordre que les messages du payload d’entrée pour faciliter le traitement des messages corrects et erronés.

Mode Sandbox

Il faut savoir que les emails envoyés en phase développement ou de test ont aussi un coût (eh oui, ils sont pris en compte dans votre quota mensuel) et qu’il est toujours possible d’envoyer des emails indésirables à vos destinataires. Si vous essayez notre API pour la première fois ou si vous voulez juste vérifier votre code, vous aurez peut-être besoin de tester un payload d’email sans avoir à envoyer un veritable email.

Pour vous faciliter la vie, nous avons intégré un mode Sandbox exclusif. Pour l’activer, paramétrez SandboxMode sur true dans votre payload d’entrée. Send API simulera ensuite le traitement de vos messages comme s’il s’agissait d’un envoi normal, mais sans les transmettre aux destinataires. Vous pouvez donc tester et modifier votre email tranquillement !

Consultez la liste complète des propriétés obligatoires et disponibles pour chaque message ici.

Tags URL

Certes, il est essentiel de pouvoir envoyer beaucoup d’emails rapidement, mais il est tout aussi important de suivre leur performance. Dans cette optique, nous vous proposons aujourd’hui tous les outils dont vous avez besoin : Send API 3.1 vous permet de nous transmettre les indicateurs de suivi dont vous avez besoin. De notre côté, nous nous assurons que tous les liens de vos emails soient dotés des bons tags pour assurer leur suivi.

Essayez-la dès maintenant !

Si vous utilisez déjà notre API, vous savez que nous mettons l’accent sur la qualité de notre documentation. Pour aider les développeurs à tirer pleinement parti de Send API v3.1, nous proposons donc une documentation complète qui vous offrira une expérience utilisateur optimale. Cette nouvelle version s’accompagne d’une bibliothèque de guides API et d’une prise en charge complète pour nos librairies. Notre objectif, c’est que vous maîtrisiez parfaitement notre API pour bénéficier de tous ses avantages.

Et enfin, nous voulons vous remercier.

Nous n’aurions jamais pu développer une version aussi performante sans l’aide précieuse de notre communauté de développeurs. Vous avez été nombreux à participer à la bêta et nous vous remercions pour votre engagement et vos retours.

C’est également grâce à notre communauté que nous avons pu créer cette version beaucoup plus avancée que l’originale, avec des améliorations considérables sur certains aspects comme les retours d’erreur. Bravo et merci à tous !

Prêts à passer à Send API v3.1 ? Plongez-vous dès maintenant dans la documentation pour vous lancer ! Nous sommes sûrs que vous allez l’adorer.

Vous utilisez Send API 3.0 ? Pas de panique ! Même si nous vous recommandons de passer à la v3.1 pour bénéficier des nouvelles fonctionnalités, nous continuerons de prendre en charge la v3.0 aussi longtemps que nécessaire. La documentation sur la migration se trouve ici. Pour toute information sur la v3, consultez cette page.

Découvrez comment améliorer votre expérience de développement avec notre site dédié aux développeurs ou abonnez-vous à notre newsletter spéciale développement pour recevoir toutes nos actualités. Pour nous contacter, direction Twitter @mailjetdev !