Skip to content

Extraire les e-mails ayant reçu un échec d’envoi définitif

get

/email/hard_bounces

Utilisez cet endpoint pour extraire une liste d’adresses e-mail ayant rejeté définitivement vos e-mails au cours d’une certaine période.

Conditions préalables

Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation email.hard_bounces.

Limite de débit

We apply the default Braze rate limit of 250,000 requests per hour to this endpoint, as documented in API rate limits.

Paramètres de demande

Paramètre Requis Type de données Description
start_date Facultatif
(voir la note)
Chaîne de caractères au format YYYY-MM-DD Date de début de la période pour récupérer les échecs d’envoi définitifs. Doit être antérieure à end_date. Ce traitement est effectué à minuit (UTC) par l’API.
end_date Facultatif
(voir la note)
Chaîne de caractères au format YYYY-MM-DD Date de fin de la période d’extraction des échecs d’envoi définitifs. Ce traitement est effectué à minuit (UTC) par l’API.
limit Facultatif Entier Champ facultatif pour limiter le nombre de résultats renvoyés. Par défaut à 100, le maximum est 500.
offset Facultatif Entier Point de départ facultatif dans la liste où récupérer les informations.
email Facultatif
(voir la note)
Chaîne de caractères S’il est fourni, nous enverrons un message indiquant si l’utilisateur a reçu un échec d’envoi définitif ou non. Vérifiez que les chaînes d’e-mails sont correctement formatées.

Si votre plage de dates dépasse le nombre limit d’échecs d’envoi définitifs, vous devrez effectuer plusieurs appels d’API, en augmentant à chaque fois le offset jusqu’à ce qu’un appel renvoie un résultat inférieur à limit ou égal à zéro. L’inclusion des paramètres offset et limit avec email peut renvoyer une réponse vide.

Exemple de demande

Réponse

Les entrées sont répertoriées par ordre décroissant.

CETTE PAGE A-T-ELLE ÉTÉ UTILE?
New Stuff!