Documentation API
Intégrez vos services e-mail avec l'API MailPass.
Base URL
https://dev.mailpass.im/api/v1
Authentification
Toutes les requêtes API doivent inclure une clé API dans l'en-tête Authorization.
Authorization: Bearer YOUR_API_KEYLes clés API peuvent être créées dans Paramètres > Clés API.
API OTP
API pour l'envoi et la vérification de codes de vérification par e-mail
POST /otp/send
POST /otp/verify
API Abonnés
API pour la gestion des abonnés et des listes
POST /subscribers
GET /subscribers
API Campagnes
API pour la création et l'envoi de campagnes e-mail
POST /campaigns
POST /campaigns/:id/send
Mail Send API
API pour l'envoi d'e-mails transactionnels (unitaire/lot)
POST /mail/send
POST /mail/send-batch
Webhooks
Configuration des webhooks pour recevoir des notifications d'événements
email.opened
email.clicked
API Rebonds
API pour le traitement et la consultation des rebonds d'e-mails
POST /bounces
GET /bounces
Format de réponse
Toutes les réponses API sont retournées au format JSON.
Réponse de succès
{
"success": true,
"data": { ... }
}Réponse d'erreur
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The email field is required."
}
}Rate Limits
Les requêtes API sont limitées à 60 par minute. En cas de dépassement du Rate limit, un code de statut 429 est retourné.