2021/01/21 by Maarten Oelering.
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.
API de Transmission PowerMTA
L'API de Transmission peut être utilisée pour soumettre des e-mails via HTTP. Auparavant, les développeurs devaient utiliser une bibliothèque cliente SMTP ou les bibliothèques clientes PowerMTA pour envoyer des e-mails. Avec cette API, soumettre un e-mail est aussi simple que d'appeler n'importe quelle autre API Web : créez un objet JSON et postez-le sur une URL.
L'API est similaire à l'API de Transmissions de Sparkpost Cloud mais elle ne prend pas en charge toutes les fonctionnalités fournies par Sparkpost Cloud. Une différence importante est que PowerMTA attend un e-mail pré-construit qui est déjà codé pour la transmission. Cela signifie que l'appelant devra créer un e-mail au format MIME correctement transfert encodé.
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.
Plus d'information
Si vous souhaitez avoir plus d'informations sur les API et les webhooks HTTP dans PowerMTA 5.0, veuillez nous envoyer un message via notre formulaire de contact.
Nous sommes toujours heureux de vous aider !
Les commentaires sont fermés.
Vous trouverez ci-dessous une liste d’articles tout aussi intéressants classés par catégorie.
Catégories
En avant