Développeurs
Développez avec l’API REST de Mailera.
Importez des boîtes aux lettres Microsoft, lisez et envoyez des messages, sortez-les du Courrier indésirable et recevez des webhooks signés.
curl https://mailera.app/api/public/v1/mailboxes \ -H "X-API-Key: mh_live_..."Démarrage rapide
- 1
Créer une API key
Inscrivez-vous gratuitement, accédez à Paramètres → API keys et choisissez les autorisations de votre clé.
- 2
Importer des boîtes aux lettres
Envoyez une liste de boîtes aux lettres au point de terminaison d’import et suivez les résultats ligne par ligne.
- 3
Lire et envoyer
Récupérez les messages par dossier, lisez les codes OTP, envoyez des messages ou répondez-y.
Groupes de points de terminaison
Boîtes aux lettres
Importez, vérifiez l’état d’activité, synchronisez, suspendez et supprimez les boîtes aux lettres.
Voir les points de terminaisonMessages
Listez, lisez, recherchez, extrayez les codes OTP, envoyez, répondez et transférez.
Voir les points de terminaisonCourrier indésirable
Vérifiez si les messages arrivent dans Boîte de réception ou Courrier indésirable, et sortez-les du Courrier indésirable.
Voir les points de terminaisonWebhooks
Abonnez-vous aux événements: nouveau message, arrivée dans Courrier indésirable et boîte aux lettres déconnectée.
Voir les points de terminaison
Autorisations des API keys
Chaque clé ne fait que ce que vous autorisez.
| Portée | Autorise |
|---|---|
read | Lire les boîtes aux lettres, les messages, les codes OTP et leur emplacement (Boîte de réception/Courrier indésirable) |
move | Sortir les messages du Courrier indésirable et les déplacer entre dossiers |
import | Ajouter des boîtes aux lettres |
sync | Demander une synchronisation immédiate |
send | Envoyer des messages, y répondre et les transférer |
manage | Suspendre, réactiver et supprimer des boîtes aux lettres |
webhooks | Gérer les webhooks |
Webhooks
Recevez des événements dès l’arrivée des messages.
Mailera envoie des requêtes POST à votre URL avec une signature HMAC-SHA256 dans l’en-tête X‑MailHub‑Signature, et réessaie automatiquement si votre point de terminaison échoue.
message.receivedUn nouveau message est arrivé dans la Boîte de réceptionmessage.junkUn nouveau message est arrivé dans le Courrier indésirablemailbox.disconnectedLa boîte aux lettres a perdu sa connexion (token révoqué, mot de passe modifié…)
Limites et détails
- Limite de requêtes
- 300 requêtes/minute par clé
- Authentification
- En-tête X-API-Key
- Boîtes aux lettres par espace de travail gratuit
- Jusqu’à 1 000 boîtes aux lettres
- Pagination
- cursor et next_cursor
- Descriptions lisibles par machine
- OpenAPI 3.1 · llms.txt