Statistiques des messages

messages:list

Affiche la liste des messages envoyés.

POST https://api.pushwoosh.com/api/v2/messages:list

En-têtes

Nom	Requis	Description
`Authorization`	Oui	Jeton API serveur. Doit être fourni dans le format suivant : `Authorization: Api <Server Key>`.

Paramètres du corps de la requête

Nom	Requis	Type	Description
`platforms`	Non	Array	Plateformes de message. Valeurs possibles : `"IOS"`, `"ANDROID"`, `"OSX"`, `"WINDOWS"`, `"AMAZON"`, `"SAFARI"`, `"CHROME"`, `"FIREFOX"`, `"IE"`, `"EMAIL"`, `"HUAWEI_ANDROID"`, `"SMS"`.
`date_range`	Non	Object	Période de rapport, filtrée sur la date de création du message. `date_from` et `date_to` doivent suivre le format `YYYY-MM-DD` (par ex., `"2000-01-01"`) ; les deux jours sont inclus en totalité, donc `date_from` et `date_to` définis à la même date retournent cette journée entière. Les dates sont interprétées en UTC, pas dans le fuseau horaire de votre compte.
`campaign`	Non	String	Code de campagne
`filters`	Oui	Object	Filtres de message.
`source`	Non	String	Source du message. Par exemple : `AB_TEST`, `API`, `AUTO_PUSH`, `CP`, `CSV`, `CUSTOMER_JOURNEY`, `EMAIL_API`, `EMAIL_CP`, `GEO_ZONE`, `PUSH_ON_EVENT`, `RSS`.
`messages_codes`	Non	Array	Codes de message obtenus à partir des réponses de l’API `/createMessage`.
`messages_ids`	Non	Array	ID de message obtenus de l’historique des messages
`params`	Non	Object	Spécifiez s’il faut afficher les détails et les métriques du message. Définissez `with_details: true` pour inclure l’objet `"details"` et `with_metrics: true` pour inclure l’objet `"metrics"` dans la réponse.
`application`	Oui	String	Code d’application Pushwoosh.
`per_page`	Non	Integer	Nombre de résultats par page, de `1` à `499`. Omettez le paramètre pour obtenir la taille de page par défaut de 500 résultats ; passer `500` ou plus explicitement est rejeté avec `400`.
`page`	Non	Integer	Numéro de page basé sur zéro pour la pagination. Voir la limite de pagination profonde ci-dessous.

Exemple de requête

{
    "filters": {
      "platforms": [],                  // IOS, ANDROID, OSX, WINDOWS, AMAZON, SAFARI, CHROME, FIREFOX, IE, EMAIL, HUAWEI_ANDROID, SMS
      "date_range": {
        "date_from": "string",          // Format requis : 2000-01-01
        "date_to": "string"             // Format requis : 2000-01-01
      },
      "source": "API",                  // AB_TEST, API, AUTO_PUSH, CP, CSV, CUSTOMER_JOURNEY, EMAIL_API, EMAIL_CP, GEO_ZONE, PUSH_ON_EVENT, RSS
      "campaign": "string",             // Code de campagne
      "messages_ids": [],               // ID de message
      "messages_codes": [],             // Codes de message
      "application": "string"           // Code d'application Pushwoosh
    },
    "params": {
      "with_details": true,             // Ajouter les détails du message à la réponse (objet "details")
      "with_metrics": true              // Ajouter les métriques du message à la réponse (objet "metrics")
    },
    "per_page": 20,                     // <= 499
    "page": 0
}

Codes de réponse et exemples

{
  "total": 0,
  "items": [{
    "id": 0,
    "code": "string",
    "created_date": "string",
    "send_date": "string",
    "status": "string",
    "platforms": [],
    "source": "string",
    "push_info": {
      "details": {
        "title": "string",
        "filter_name": "string",
        "filter_code": "string",
        "content": {
          "key": "value"
        },
        "platform_parameters": {
          "android_header": "string",
          "android_root_params": {
            "key": "value"
          },
          "ios_title": "string",
          "ios_subtitle": "string",
          "ios_root_params": {
            "key": "value"
          },
          "chrome_header": "string",
          "chrome_root_params": {
            "key": "value"
          },
          "firefox_header": "string",
          "firefox_root_params": {
            "key": "value"
          },
          "conditions": [               // conditions de tag (voir /developer/api-reference/messages-api/#tag-conditions)
            TAG_CONDITION1,
            TAG_CONDITION2,
            ...,
            TAG_CONDITIONN
          ],
          "conditions_operator": "AND", // opérateur logique pour les tableaux de conditions ; valeurs possibles : AND, OR
          "data": {
            "key": "value"
          }
        },
        "follow_user_timezone": true
      },
      "metrics": [{
        "sends": 0,
        "opens": 0,
        "deliveries": 0,
        "inbox_opens": 0,
        "unshowable_sends": 0,
        "errors": 0,
        "platform": 0
      }]
    },
    "email_info": {
      "details": {
        "template": "string",
        "filter_name": "string",
        "filter_code": "string",
        "subject": {
          "key": "value"
        },
        "from_name": "string",
        "from_email": "string",
        "reply_name": "string",
        "reply_email": "string",
        "follow_user_timezone": true,
        "conditions": [              // conditions de tag (voir Messages-api - tag-conditions)
          TAG_CONDITION1,
          TAG_CONDITION2,
          ...,
          TAG_CONDITIONN
        ],
        "conditions_operator": "AND" // opérateur logique pour les tableaux de conditions ; valeurs possibles : AND, OR
      },
      "metrics": [{
        "sends": 0,
        "opens": 0,
        "deliveries": 0,
        "hard_bounces": 0,
        "soft_bounces": 0,
        "rejects": 0,
        "confirmed_sends": 0,
        "unsubs": 0,
        "complaints": 0,
        "errors": 0
      }]
    }
  }]
}

date_range couvre plus de 30 jours :

{
  "error": "exceeded the maximum date interval. Max interval: 30 days"
}

page × per_page dépasse la limite de pagination profonde :

{
  "error": "requested result window is too large, narrow the date range"
}

{
  "error": "account not found"
}

totalsByIntervals

Retourne les métriques et les données de conversion basées sur le code du message, agrégées par heure.

POST https://api.pushwoosh.com/api/v2/statistics/messages/totalsByIntervals

Autorisation

L’autorisation est gérée via le jeton d’accès API dans l’en-tête de la requête.

Paramètres du corps de la requête

Nom du paramètre	Type	Description	Requis
`message_code`	string	Code de message obtenu à partir des réponses de l’API `/createMessage`.	Oui
`platforms`	[int]	Plateformes	Non

Exemple de requête

{
  "message_code": "XXXXX-XXXXXXXXX-XXXXXXXX", // requis. Identifiant unique du message
  "platforms": [1, 3, 7, 10, 11, 12]          // optionnel. Liste des codes de plateforme
}

Champs de la réponse

Nom	Type	Description
`metrics`	array	Contient un tableau de métriques de message
`timestamp`	string	L’heure de la métrique.
`platform`	int	Le code de la plateforme (par ex., iOS, Android).
`sends`	string	Le nombre de messages envoyés.
`opens`	string	Le nombre de messages ouverts.
`deliveries`	string	Le nombre de messages livrés.
`inbox_opens`	string	Le nombre d’ouvertures de la boîte de réception.
`unshowable_sends`	string	Le nombre de messages acceptés pour les appareils dont les notifications sont désactivées dans les paramètres de l’OS. Aucune bannière n’est affichée, mais le message atteint quand même l’application, et il apparaît dans la Boîte de réception des messages si l’envoi a l’option Enregistrer le message dans la boîte de réception activée. Comptabilisé comme des envois réussis, pas comme des erreurs.
`errors`	string	Le nombre d’erreurs.
`conversion`	object	Contient des données de conversion
`sends`	string	Le nombre total de messages envoyés.
`opens`	string	Le nombre total de messages ouverts.
`events`	array	Un tableau d’événements avec leurs statistiques
`name`	string	Le nom de l’événement (par ex., ajout au panier).
`hits`	string	Le nombre de hits.
`conversion`	float	Le taux de conversion par rapport aux ouvertures.
`revenue`	float	Le revenu (uniquement pour les événements avec les attributs `__amount` et `__currency`).

Exemple de réponse

{
  "metrics": [{
    "timestamp": "2024-08-03 15:00:00",  // Horodatage des métriques au format "YYYY-MM-DD HH:MM:SS"
    "platform": 3,                       // Code de la plateforme
    "sends": "55902",                    // Nombre de messages envoyés
    "opens": "382",                      // Nombre de messages ouverts
    "deliveries": "22931",               // Nombre de messages livrés
    "inbox_opens": "0",                  // Nombre de messages ouverts dans la boîte de réception
    "unshowable_sends": "2",             // Envoyé aux appareils avec les notifications désactivées, aucune bannière affichée
    "errors": "0"                        // Nombre d'erreurs rencontrées
  }],
  "conversion": {
    "sends": "55902",                    // Nombre total de messages envoyés
    "opens": "772",                      // Nombre total de messages ouverts
    "events": [{
      "name": "cart_add",                // Nom de l'événement
      "hits": "96",                      // Nombre de hits pour l'événement
      "conversion": 0.12,                // Taux de conversion par rapport aux ouvertures
      "revenue": 0                       // Revenu généré par l'événement (uniquement pour les événements avec des attributs de montant/devise)
    }]
  }
}

getMessageLog

Affiche des informations détaillées sur les messages envoyés.

POST https://api.pushwoosh.com/api/v2/statistics/getMessageLog

En-têtes

Nom	Requis	Description
`Authorization`	Requis	Jeton d’accès API depuis le Panneau de Contrôle Pushwoosh.

Paramètres du corps de la requête

Nom	Requis	Type	Description
`message_id`	Non	Integer	Sélectionne les événements de message par ID de message obtenu de l’historique des messages. Exemple : `12345678900`.
`message_code`	Non	String	Sélectionne les événements de message par Code de message obtenu des réponses de l’API `/createMessage`. Exemple : `"A444-AAABBBCC-00112233"`.
`campaign_code`	Non	String	Sélectionne les événements de message par Code de campagne spécifié dans la charge utile de votre message. Exemple : `"AAAAA-XXXXX"`.
`hwid`	Non	String ou Array	Sélectionne les événements de message par HWID (Hardware ID) ou un tableau de HWID.
`date_from`	Requis si `message_id`, `message_code`, ou `campaign_code` n’est pas fourni	Datetime	Date de début pour le filtrage des messages. Format : `"YYYY-MM-DD HH:MM:SS"`. Exemple : `"2000-01-25 00:00:00"`.
`date_to`	Requis si `message_id`, `message_code`, ou `campaign_code` n’est pas fourni	Datetime	Date de fin pour le filtrage des messages. Format : `"YYYY-MM-DD HH:MM:SS"`. Exemple : `"2000-01-26 00:00:00"`.
`limit`	Non	Integer	Nombre maximum d’événements de message retournés dans une seule réponse. Valeur maximale : `100000`.
`pagination_token`	Non	String	Jeton de pagination obtenu d’une réponse `/getMessageLog` précédente. Utilisez-le pour récupérer des résultats supplémentaires.
`user_id`	Non	String	Sélectionne les événements de message par un User ID personnalisé. Voir `/registerUser` pour plus de détails.
`application_code`	Oui	String	Sélectionne les événements de message par Code d’application Pushwoosh
`actions`	Non	Array	Filtre les résultats par actions de message spécifiques. Valeurs possibles : `"sent"`, `"delivered"`, `"opened"`, `"reject"`, `"create"`, `"inbox_delivered"`, `"inbox_read"`, `"inbox_opened"`, `"inbox_deleted"`. Les événements `"create"` sont exclus de la réponse par défaut. Incluez `"create"` dans ce tableau pour les voir. Les événements `"delivered"` nécessitent en plus que les statistiques de livraison soient activées sur le compte.
`platforms`	Non	Array	Tableau des plateformes cibles pour filtrer les résultats. Valeurs possibles : `"unknown"`, `"ios"`, `"blackberry"`, `"android"`, `"windows phone"`, `"osx"`, `"windows"`, `"amazon"`, `"safari"`, `"chrome"`, `"firefox"`, `"ie"`, `"email"`, `"fb messenger"`, `"baidu android"`, `"huawei android"`, `"sms"`, `"xiaomi"`, `"web"`, `"whatsapp"`, `"line"`, `"kakao"`, `"telegram"`, `"apple wallet"`, `"google wallet"`, `"viber"`.
`message_type`	Non	String	Filtre les résultats par flux de messages. `"all"` (par défaut si omis) retourne tout, `"broadcast"` retourne uniquement les messages de masse (`message_id != 0`), `"transactional"` retourne uniquement les messages avec `message_id = 0`, y compris ceux envoyés depuis Customer Journey.

Exemple de requête

curl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/getMessageLog' \
--header 'Authorization: Key API_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
   "pagination_token": "PAGINATION_TOKEN_FROM_PREVIOUS_RESPONSE",  // optionnel, jeton pour la pagination
   "limit": 1000,                                  // optionnel, le nombre max d'entrées pour une seule réponse
   "application_code": "XXXXX-XXXXX",              // Code d'application Pushwoosh
   "message_code": "A444-AAABBBCC-00112233",       // optionnel, code de message obtenu de la requête /createMessaage
   "message_id": 1234567890,                       // optionnel, ID de message obtenu du Panneau de Contrôle Pushwoosh
   "campaign_code": "AAAAA-XXXXX",                 // optionnel, code d'une campagne pour obtenir le journal
   "hwid": "aaazzzqqqqxxx",                        // optionnel, ID matériel d'un appareil spécifique ciblé par un message
   "user_id": "user_123",                          // optionnel, ID d'un utilisateur ciblé par le message
   "date_from": "2000-01-25 00:00:00",             // optionnel, début de la période des statistiques
   "date_to": "2000-02-10 23:59:59",               // optionnel, fin de la période des statistiques
   "actions": ["opened", "inbox_opened"],          // optionnel, utilisé pour la filtration des résultats. Valeurs possibles : "sent", "delivered", "opened", "reject", "create", "inbox_delivered", "inbox_read", "inbox_opened", "inbox_deleted". La réponse inclura tous les messages avec la ou les actions spécifiées.
   "platforms": ["ios", "chrome"],                 // optionnel, utilisé pour la filtration des résultats, en minuscules uniquement. Valeurs possibles : "unknown", "ios", "blackberry", "android", "windows phone", "osx", "windows", "amazon", "safari", "chrome", "firefox", "ie", "email", "fb messenger", "baidu android", "huawei android", "sms", "xiaomi", "web", "whatsapp", "line", "kakao", "telegram", "apple wallet", "google wallet", "viber"
   "message_type": "broadcast"                     // optionnel, "all" (par défaut), "broadcast" (message_id != 0), ou "transactional" (message_id = 0, inclut les envois de Customer Journey)
}'

Codes de réponse et exemples

{
  "pagination_token": "PAGINATION_TOKEN_FOR_NEXT_REQUEST",
  "data": [{
    "timestamp": "2000-01-25T11:18:47Z",
    "application_code": "XXXXX-XXXXX",
    "message_id": 12345678900,
    "message_code": "A444-AAABBBCC-00112233",
    "campaign_code": "AAAAA-XXXXX",
    "hwid": "aaazzzqqqqxxx",
    "user_id": "user_123",
    "platform": "android",
    "action": "sent",
    "status": "success",
    "push_alerts_enabled": "true"
  }, {
    "timestamp": "2000-01-25T11:18:49Z",
    "application_code": "XXXXX-XXXXX",
    "message_id": 12345678900,
    "message_code": "A444-AAABBBCC-00112233",
    "campaign_code": "AAAAA-XXXXX",
    "hwid": "aaazzzqqqqxxx",
    "user_id": "user_123",
    "platform": "android",
    "action": "delivered",
    "push_alerts_enabled": "true"
  }, {
    "timestamp": "2000-01-25T11:19:23Z",
    "application_code": "XXXXX-XXXXX",
    "message_id": 12345678900,
    "message_code": "A444-AAABBBCC-00112233",
    "campaign_code": "AAAAA-XXXXX",
    "hwid": "aaazzzqqqqxxx",
    "user_id": "user_123",
    "platform": "android",
    "action": "opened",
    "push_alerts_enabled": "true"
  }, {
    "timestamp": "2000-01-25T11:19:30Z",
    "application_code": "XXXXX-XXXXX",
    "message_id": 12345678900,
    "message_code": "A444-AAABBBCC-00112233",
    "campaign_code": "AAAAA-XXXXX",
    "hwid": "aaazzzqqqqxxx",
    "user_id": "user_123",
    "platform": "android",
    "action": "reject",
    "status": "failed",
    "error_reason": "invalid device token",
    "payload": "SOME_PAYLOAD_STRING"
  }]
}

{
  "error": "exceeded the maximum date interval. Max interval: 30 days"
}

{
  "error": "account not found"
}

Chaque entrée dans data contient également error_reason (chaîne de caractères, remplie avec la raison de l’échec lorsque status est "failed") et un payload optionnel (chaîne de caractères).

Une page de réponse peut revenir plus courte que la limit demandée. Cela ne signifie pas en soi que l’exportation est terminée.

Statistiques des e-mails

linksInteractions

Affiche les statistiques sur les clics de liens dans les e-mails

POST https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractions

En-têtes

Nom	Requis	Description
`Authorization`	Oui	Jeton d’accès API depuis le Panneau de Contrôle Pushwoosh.

Paramètres du corps de la requête

Nom	Requis	Type	Description
`date_range`	Non	Object	Définit la période de rapport. Contient `date_from` et `date_to`.
`filters`	Oui	Object	Filtres d’e-mail.
`application`	Oui	String	Code d’application Pushwoosh (alternativement, spécifiez `campaign`, `messages_ids`, ou `message_codes`).
`messages_codes`	Oui	Array	Codes de message (alternativement, spécifiez `application`, `campaign`, ou `messages_ids`).
`campaign`	Oui	String	Code de campagne (alternativement, spécifiez `application`, `messages_ids`, ou `message_codes`).
`messages_ids`	Oui	Array	ID de message (alternativement, spécifiez `application`, `campaign`, ou `message_codes`).
`link_template`	Requis si `application` ou `campaign` est spécifié.	String	Filtre les interactions de liens d’e-mail par mot-clé. Seuls les liens qui incluent le texte spécifié dans leur URL seront retournés dans la réponse de l’API. Par exemple, si votre e-mail contient des liens comme `https://example.com/news` et `https://example.com/shop`, définir “link_template”: “shop” retournera uniquement les interactions pour `https://example.com/shop`.
`email_content_code`	Non	String	Identifiant unique pour le contenu de l’e-mail.
`params`	Non	Object	Définit des options de réponse supplémentaires. Inclut `with_full_links`, qui ajoute une liste de liens complets avec des statistiques.

Exemple de requête

curl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractions' \
--header 'Authorization: Api API_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
   "filters": {
      "date_range": {
         "date_from": "string",           // Format requis : 2000-01-01
         "date_to": "string"              // Format requis : 2000-01-01
      },
      "campaign": "string",               // Code de campagne (vous pouvez spécifier application, messages_ids, ou message_codes à la place)
      "application": "string",            // Code d'application (vous pouvez spécifier campaign, messages_ids, ou message_codes à la place)
      "messages_ids": [],                 // ID de message (vous pouvez spécifier application, campaign, ou message_codes à la place)
      "messages_codes": [],               // Codes de message (vous pouvez spécifier application, campaign, ou message_ids à la place)
      "link_template": "string",          // Modèle de lien (requis si application ou campaign est spécifié)
      "email_content_code": "string"      // Identifiant unique pour le contenu de l'e-mail.
   },
   "params": {
      "with_full_links": true             // Spécifiez s'il faut afficher des statistiques détaillées. Une liste de liens complets avec des statistiques sera passée dans le tableau full_links.
   }
}'

Codes de réponse et exemples

{
  "items": [{
    "template": "string",
    "link": "string",
    "title": "string",
    "clicks": 0,
    "full_links": [{
      "full_link": "string",
      "clicks": 0
    }]
  }]
}

{
  "error": "exceeded the maximum date interval. Max interval: 30 days"
}

{
  "error": "account not found"
}

linksInteractionsDevices

Affiche les utilisateurs qui ont cliqué sur des liens dans les e-mails

POST https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractionsDevices

En-têtes

Nom	Requis	Description
`Authorization`	Oui	Jeton d’accès API depuis le Panneau de Contrôle Pushwoosh.

Paramètres du corps de la requête

Nom	Requis	Type	Description
`date_range`	Non	Object	Définit la période de rapport. Contient `date_from` et `date_to`.
`filters`	Oui	Object	Filtres d’e-mail.
`application`	Oui	String	Code d’application Pushwoosh (alternativement, spécifiez `campaign`, `messages_ids`, ou `message_codes`).
`messages_codes`	Oui	Array	Codes de message (alternativement, spécifiez `application`, `campaign`, ou `messages_ids`).
`campaign`	Oui	String	Code de campagne (alternativement, spécifiez `application`, `messages_ids`, ou `message_codes`).
`messages_ids`	Oui	Array	ID de message (alternativement, spécifiez `application`, `campaign`, ou `message_codes`).
`link_template`	Requis si `application` ou `campaign` est spécifié.	String	Filtre les interactions de liens d’e-mail par mot-clé. Seuls les liens qui incluent le texte spécifié dans leur URL seront retournés dans la réponse de l’API. Par exemple, si votre e-mail contient des liens comme `https://example.com/news` et `https://example.com/shop`, définir “link_template”: “shop” retournera uniquement les interactions pour `https://example.com/shop`.
`email_content_code`	Non	String	Identifiant unique pour le contenu de l’e-mail.
`page`	Non	Integer	Numéro de page pour la pagination.
`per_page`	Non	Integer	Nombre de résultats par page (≤ 1000).

Exemple de requête

curl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractionsDevices' \
--header 'Authorization: Api API_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
   "filters": {
      "date_range": {
         "date_from": "string",         // Format requis : 2000-01-01
         "date_to": "string"            // Format requis : 2000-01-01
      },
      "campaign": "string",             // Code de campagne (vous pouvez spécifier application, messages_ids, ou message_codes à la place)
      "application": "string",          // Code d'application (vous pouvez spécifier campaign, messages_ids, ou message_codes à la place)
      "messages_ids": [],               // ID de message (vous pouvez spécifier application, campaign, ou message_codes à la place)
      "messages_codes": [],             // Codes de message (vous pouvez spécifier application, campaign, ou message_ids à la place)
      "link_template": "string",        // Modèle de lien (requis si application ou campaign est spécifié)
      "email_content_code": "string"    // Identifiant unique pour le contenu de l'e-mail.
   },
   "per_page": 100,
   "page": 0
}'

Codes de réponse et exemples

{
  "total": 0,
  "items": [{
    "timestamp": "string",
    "link": "string",
    "hwid": "string"
  }]
}

{
  "error": "exceeded the maximum date interval. Max interval: 30 days"
}

{
  "error": "account not found"
}

bouncedEmails

POST https://api.pushwoosh.com/api/v2/statistics/emails/bouncedEmails

Fournit des données sur les plaintes par e-mail, les soft bounces et les hard bounces, y compris la date, l’adresse e-mail et la raison de chaque rebond.

Autorisation

L’autorisation est gérée via le jeton d’accès API dans l’en-tête de la requête.

Paramètres du corps de la requête

Nom du paramètre	Type	Description	Requis
`application`	string	Code d’application Pushwoosh	Oui
`message_code`	string	Code de message.	Requis si `date range` ou `campaign` n’est pas fourni
`campaign`	string	Code de campagne.	Requis si `message_code` ou `date range` n’est pas fourni
`date_from`	string	La date de début pour les données au format `YYYY-MM-DDTHH:MM:SS.000Z` (norme ISO 8601).	Requis si `message_code` ou `campaign` n’est pas fourni
`date_to`	string	La date de fin pour les données au format `YYYY-MM-DDTHH:MM:SS.000Z` (norme ISO 8601).	Requis si `message_code` ou `campaign` n’est pas fourni
`per_page`	int	Le nombre de lignes par page, maximum 5000.	Oui
`page`	int	Le numéro de page, à partir de zéro.	Oui
`type`	string	Le type de rebond : Complaint, Softbounce, Hardbounce.	Non

Exemple de requête

{
  "application": "XXXXX-XXXXX",               // requis. Code d'application Pushwoosh
  "message_code": "XXXXX-XXXXXXXXX-XXXXXXXX", // requis si la campagne ou la plage de dates n'est pas fournie.
                                              //          Identifiant unique du message
  "campaign": "XXXXX-XXXXX",                  // requis si le code de message ou la plage de dates n'est pas fourni.
                                              //          Code de campagne
  "date_from": "2024-07-20T00:00:00.000Z",    // requis si le code de message ou la campagne n'est pas fourni.
                                              //          Date de début au format ISO 8601 "YYYY-MM-DDTHH:MM:SS.SSSZ"
  "date_to": "2024-07-20T00:00:00.000Z",      // requis si le code de message ou la campagne n'est pas fourni.
                                              //          Date de fin au format ISO 8601 "YYYY-MM-DDTHH:MM:SS.SSSZ"
  "per_page": 1000,                           // requis. Nombre de résultats par page, maximum 5000
  "page": 5,                                  // optionnel. Numéro de page, à partir de zéro
  "type": "Softbounce"                        // optionnel. Le type de rebond : Complaint, Softbounce, Hardbounce
}

Champs de la réponse

Nom du champ	Type	Description
`total`	int	Le nombre total de lignes.
`bounced_emails`	array	Un tableau de détails sur les e-mails retournés.
├── `email`	string	L’adresse e-mail qui a été retournée.
├── `date`	string	La date du rebond (format : `YYYY-MM-DDTHH:MM:SS.000Z`).
├── `reason`	string	La raison du rebond.
└── `type`	string	Le type de rebond : Complaint, Softbounce, Hardbounce.

Exemple de réponse

{
  "total": 25,                             // Nombre total de lignes.
  "bounced_emails": [{
    "email": "example@example.com",        // Adresse e-mail qui a été retournée
    "date": "2024-07-20T00:00:00.000Z",    // Date du rebond au format ISO 8601
    "reason": "Invalid recipient address", // Raison du rebond
    "type": "Hardbounce"                   // Type de rebond : Complaint, Softbounce, Hardbounce
  }]
}