API et webhooks HTTP dans PowerMTA 5.0

Le protocole standard de transfert des e-mails est SMTP et la norme MIME est utilisée pour encoder les e-mails avant le transfert. En tant que principal agent de transfert d'e-mails, l'implémentation de SMTP dans PowerMTA est extrêmement robuste et performante. PowerMTA prend également en charge les dernières extensions SMTP pour l'internationalisation, l'authentification et le cryptage.

Mais SMTP et MIME ne communiquent pas bien avec les applications modernes et d'autres langages comme HTTP et JSON. Cela peut parfois compliquer l'intégration d'un MTA dans une infrastructure basée sur les normes Web. Heureusement, depuis la version 5.0 PowerMTA prend en charge une liste d'API et de webhooks HTTP.

API et webhooks disponibles dans PowerMTA

Au total, quatre API sont disponibles dans la version 5.0r6 :

• API de transmission pour l'injection des e-mails
• API de configuration pour la mise à jour des fichiers de configuration
• API de commande pour exécuter des commandes
• API de surveillance pour monitorer PowerMTA

Il existe aussi deux webhooks qui peuvent être utilisés pour pousser des données vers une application Web:

• Delivery webhook pour recevoir les e-mails entrants
• Webhook des fichier accounting pour recevoir les données de transaction

Dans cet article, nous allons décrire plus en détail l'API de transmission et le webhook des fichiers accounting. Grâce à ces 2 fonctionnalités vous pouvez transformer PowerMTA en votre propre service d'envoi SMTP privé, similaire à des services comme Sparkpost Cloud ou Sendgrid.

Webhook des fichiers accounting

L'API HTTP la plus intéressante est probablement le webhook des fichiers accounting. Ce webhook permet de transmettre des données d'événement telles que les bounces ou les plaintes à des applications Web. Avant que ce webhook intégré ne soit disponible, Postmastery a développé son add-on webhook qui est installé sur des dizaines de systèmes PowerMTA.

Le webhook fonctionne de la même manière que les webhooks d'événements fournis par les fournisseurs de services SMTP. Les événements tels que les messages soumis, les reports, les messages reçus, les bounces et les plaintes sont envoyés vers une URL de votre choix. Chaque post contient un lot d'événements encodés en JSON ou CSV qui sera tenté à nouveau en cas d'erreur.

Configuration des API HTTP

La configuration des API HTTP est expliquée dans le Guide de l'utilisateur et est assez simple à faire. Ce qui peut être un peu délicat, c'est l'utilisation de HTTPS. Nous pouvons vous aider à configurer un certificat de validation Let's Encrypt pour les points de terminaison et des certificats CA pour les webhooks.