Permission requise : subscribers
Types de rebonds
| Type | Description | Action |
|---|---|---|
hard |
Échec de livraison permanent (adresse e-mail inexistante) | Désabonnement immédiat |
soft |
Échec de livraison temporaire (boîte aux lettres pleine, etc.) | Désabonnement après 3 occurrences |
complaint |
Signalement de spam | Désabonnement immédiat |
GET
/api/v1/bounces
Récupère la liste des rebonds.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
limit |
integer | Nombre de résultats (par défaut : 20, max : 100) |
offset |
integer | Décalage de pagination |
Response
{
"success": true,
"data": {
"bounces": [
{
"id": 1,
"email": "invalid@example.com",
"bounce_type": "hard",
"bounce_subtype": "NoEmail",
"source": "ses",
"campaign_name": "January Newsletter",
"subscriber_name": "John Doe",
"created_at": "2026-01-10T12:00:00Z"
}
],
"total": 50,
"limit": 20,
"offset": 0
}
}
POST
/api/v1/bounces
Enregistre manuellement un rebond.
Request Body
{
"email": "invalid@example.com",
"bounce_type": "hard", // hard, soft, complaint
"bounce_subtype": "NoEmail", // optional
"diagnostic_code": "550 5.1.1..." // optional
}Response
{
"success": true,
"data": {
"bounce_id": 123
}
}Webhooks des fournisseurs d'e-mail
Vous pouvez recevoir automatiquement les notifications de rebonds de fournisseurs tels qu'AWS SES, Mailgun, SendGrid, etc.
URLs de webhook
| Provider | Webhook URL |
|---|---|
| AWS SES (SNS) | https://dev.mailpass.im/api/v1/webhooks/ses |
| Mailgun | https://dev.mailpass.im/api/v1/webhooks/mailgun |
| SendGrid | https://dev.mailpass.im/api/v1/webhooks/sendgrid |
Configuration AWS SES
- Créez un nouveau Topic dans AWS SNS.
- Ajoutez un abonnement HTTPS au Topic :
https://dev.mailpass.im/api/v1/webhooks/ses - Créez un Configuration Set dans AWS SES.
- Ajoutez une Event Destination au Configuration Set et sélectionnez le SNS Topic.
- Sélectionnez les événements Bounce et Complaint.
Politique de traitement des rebonds
- • En cas de Hard Bounce, l'abonné concerné passe immédiatement au statut 'bounced'.
- • Après 3 Soft Bounces consécutifs, le rebond est traité comme un Hard Bounce.
- • En cas de signalement de spam, l'abonné concerné passe au statut 'unsubscribed'.
- • Aucun e-mail ne sera envoyé aux adresses ayant rebondi.
Bonnes pratiques
- • Maintenez un taux de rebonds inférieur à 5 %. Un taux élevé nuit à votre réputation d'expéditeur.
- • Vérifiez régulièrement la liste des rebonds et nettoyez les adresses invalides.
- • Utilisez le Double Opt-in pour ne collecter que des adresses valides.
- • Envisagez la vérification en temps réel lors de la collecte d'adresses e-mail.