API — questions fréquentes
Des réponses rapides pour les développeurs qui intègrent Mailpro.
Comment obtenir une clé API ?+
Connectez-vous à votre compte Mailpro et ouvrez Paramètres → Accès API. Vous y trouverez votre identifiant client numérique et votre clé API (GUID). Vous pouvez appeler les API directement avec ceux-ci, ou les échanger contre un jeton OAuth 2.0 / Bearer JWT depuis l'endpoint de jetons.
Quelles méthodes d'authentification sont prises en charge ?+
Trois : OAuth 2.0 avec PKCE (recommandé pour les applications tierces et les plateformes comme Zapier, Make et n8n), Bearer JWT (héritage) et id_client + clé API. Un seul jeton OAuth fonctionne sur les API Email, CRM et SMS.
Les API sont-elles REST ou SOAP ?+
Ce sont des API REST modernes en HTTPS. Les réponses sont en JSON par défaut (les API Email et SMS prennent aussi en charge le XML), avec des ressources prévisibles, des verbes HTTP standards et des codes de statut.
Existe-t-il une documentation interactive ou un mode test ?+
Oui. Chaque endpoint peut être essayé en direct depuis la documentation interactive Swagger, et vous pouvez envoyer des emails et des SMS de test à votre propre adresse avant de passer en production.
Quels langages et SDK puis-je utiliser ?+
N'importe quel langage capable de parler HTTP et JSON. Nous publions un SDK officiel sur GitHub et fournissons des exemples prêts à l'emploi en curl, Node.js, Python, PHP et C#.
Les API prennent-elles en charge les webhooks ?+
Oui. Abonnez-vous aux événements en temps réel — email délivré, ouvert, cliqué, rejeté, ainsi que les rapports de livraison SMS — transmis sous forme de callbacks HTTP signés en HMAC-SHA256.
Puis-je envoyer des emails transactionnels, pas seulement des campagnes ?+
Oui. Envoyez un email unique à un seul destinataire avec des champs personnalisés, des pièces jointes et une planification optionnelle, à l'aide de l'Email API ou de la CRM API.
Puis-je envoyer des pièces jointes ? Quelles sont les limites et le coût ?+
Oui — joignez des fichiers lorsque vous envoyez un email via l'Email API (v2) ou la CRM API (v3) : jusqu'à 5 fichiers, 10 MB par fichier et 15 MB au total. Envoyez-les en pièces jointes encodées en Base64 sur l'une ou l'autre API (l'Email API accepte aussi les téléversements de fichiers multipart/form-data). Le coût est de 1 crédit par 500 KB de pièces jointes, les premiers 500 KB étant inclus dans le crédit de base de l'email (les pièces jointes jusqu'à ~500 KB n'ajoutent donc rien). Les formats de documents et d'images courants sont acceptés ; les fichiers exécutables et scripts (.exe, .bat, .js, .vbs, .msi, .jar, .dll, etc.) sont bloqués pour des raisons de sécurité.
Comment fonctionne la tarification des SMS ?+
Le SMS fonctionne par crédits. Un SMS coûte le prix en crédits du pays de destination multiplié par le nombre de parties (un message long est découpé en plusieurs parties). L'envoi d'emails utilise des crédits email.
Quels formats d'adresse email sont acceptés ?+
Toute adresse conforme à la RFC, y compris le sous-adressage avec un « + » (par exemple [email protected]), pris en charge par Gmail, Fastmail, Proton et d'autres.
Quelles sont les limites de débit ?+
Les requêtes sont limitées en débit par compte. Lorsque vous dépassez la limite, vous recevez une réponse HTTP 429 avec des en-têtes clairs, afin de pouvoir temporiser et réessayer proprement.
