Documentation Mailbeam
Tout ce qu'il vous faut pour intégrer la vérification d'e-mails en temps réel à votre application.
Mailbeam est une API REST qui contrôle si une adresse e-mail peut réellement recevoir du courrier. Vous envoyez une adresse à POST /v1/verify et recevez un statut, un score et le motif qui va avec ; ou vous soumettez jusqu'à 500 000 adresses à POST /v1/verify/batch et récupérez les résultats de façon asynchrone. L'authentification est un jeton Bearer ; il n'y a rien d'autre à installer.
- URL de base
- https://api.mailbeam.dev
- Version actuelle
- /v1/ — 12 mois de préavis de dépréciation
- Authentification
- Authorization: Bearer mb_live_…
- Plafond par lot
- 500 000 adresses par tâche
Démarrage rapide
Votre première vérification en 5 minutes.
Authentification
Clés d'API, jetons Bearer et rotation des clés.
Limites de débit
Quotas, en-têtes et stratégie de backoff.
Erreurs
Codes d'erreur, structure et traitement.
Webhooks
Livraison d'événements en temps réel et vérification HMAC.
SDKPrévu
Bibliothèques officielles pour Node, Python, PHP, Ruby et Go.
Vous cherchez la référence de l'API ?
La documentation complète des endpoints, avec les schémas de requête et de réponse et des exemples interactifs.
Aller à la référence de l'APIVous venez d'un autre prestataire ?
Questions fréquentes
L'API Mailbeam est-elle disponible aujourd'hui ?
Oui. L'API publique est ouverte à toute personne qui s'inscrit. L'offre Free couvre 1 000 vérifications par mois sans carte, et une clé d'API vous attend dans le tableau de bord dès votre première connexion.
Que faut-il pour faire son premier appel à l'API Mailbeam ?
Une clé d'API, envoyée comme jeton Bearer dans l'en-tête Authorization, et une requête JSON vers un endpoint sous https://api.mailbeam.dev/v1/. Le démarrage rapide déroule une vérification complète de bout en bout.
Comment Mailbeam gère-t-il les versions de son API ?
La version actuelle est v1, et tous les endpoints se trouvent sous /v1/. La compatibilité ascendante est tenue à l'intérieur d'une version ; les changements incompatibles vont dans une nouvelle version, et l'ancienne est marquée dépréciée avec au moins 12 mois de préavis.
Quelle est la différence entre vérification en temps réel et vérification par lots ?
La vérification en temps réel passe par POST /v1/verify, répond sur une adresse par requête et ne conserve aucune adresse. La vérification par lots passe par POST /v1/verify/batch, accepte jusqu'à 500 000 adresses par tâche, s'exécute de façon asynchrone et garde les résultats 72 heures pour que vous puissiez les récupérer.
Réponses vérifiées sur le contrat de l'API le .