API Audience

bulkSetTags

POST https://api.pushwoosh.com/api/v2/audience/bulkSetTags

Définit les valeurs des tags pour la liste des appareils.

Corps de la requête

Nom	Type	Description
application*	String	Code d’application Pushwoosh
auth*	String	Jeton d’accès API depuis le Control Panel de Pushwoosh.
create_missing_tags	Boolean	Si la valeur est `true`, les tags manquants sont créés automatiquement.
devices*	Object	Tableau d’appareils.
devices.hwid	String	Peut être utilisé pour identifier un appareil à la place de `user_id` ou `push_token`. En savoir plus
devices.user_id	String	Peut être utilisé pour identifier un utilisateur à la place de `hwid` ou `push_token`
devices.push_token	String	Peut être utilisé pour identifier un appareil à la place de `hwid` ou `user_id`
devices.list_operator	String	Définit comment définir les valeurs pour les tags de type liste : `set`, `append` ou `remove`
devices.tags*	Object	Valeurs à définir pour les tags spécifiés.

OK
Erreur

{
  "request_id": "ID de requête à utiliser dans la méthode GET pour obtenir l'état de la tâche",
  "status": "Pending"
}

{
  "message": "invalid request"
}

{
  "application": "code d'application",   // requis. Code d'application Pushwoosh
  "auth": "jeton d'authentification Pushwoosh",      // requis. Jeton d'accès API depuis le Control Panel de Pushwoosh
  "create_missing_tags": false,        // optionnel. Doit créer automatiquement les tags manquants
  "devices": [{                        // requis. Tableau d'appareils
    "hwid": "hwid de l'appareil",             // optionnel. Peut être utilisé pour identifier un appareil à la place de
                                       //           "user_id" ou "push_token".
    "user_id": "ID utilisateur",              // optionnel. Peut être utilisé pour identifier un utilisateur à la place de "hwid" ou "push_token".
    "push_token": "jeton push de l'appareil", // optionnel. Peut être utilisé pour identifier un appareil à la place de "hwid" ou "user_id".
    "list_operator": "set",            // requis. Pour les tags de liste. Définit comment définir les valeurs pour les
                                       //           tags de type liste : set, append ou remove
    "tags": {                          // requis. Valeurs à définir pour les tags spécifiés.
      "tag_name": "valeur_tag",          //           utiliser le type de valeur correct
      "tag_name2": "valeur_tag2"
    }
  }]
}

{
  "request_id": "ID de requête à utiliser dans la méthode GET pour obtenir l'état de la tâche",
  "status": "Pending"
}

État de bulkSetTags

GET https://api.pushwoosh.com/api/v2/audience/bulkSetTags/{request_id}?detailed=false

Renvoie l’état de l’opération /bulkSetTags

Paramètres de chemin

Nom	Type	Description
request_id	String	ID de requête de l’appel /bulkSetTags précédent

Paramètres de requête

Nom	Type	Description
detailed	Boolean	(true/false) indique s’il faut renvoyer des informations détaillées par appareil

{
  "request_id": "id de la requête",
  "status": "Completed",          // aussi "Pending", "Failed"
  "progress": 100,                // progression de la tâche 0-100
  "devices_success": 100,         // appareils valides
  "devices_not_found": 0,         // appareils non trouvés dans Pushwoosh
  "devices_failed": 0,            // en erreur
  "devices": [{                   // rapport d'appareil (uniquement si detailed = true)
    "hwid": "hwid de l'appareil",
    "status": "done",             // aussi "failed", "not found"
    "tags": {
      "tagName": "ok",
      "tagName2": "tag non trouvé",
      "tagName3": "valeur incorrecte. attendu :string",
    }
  }]
}

bulkRegisterDevice

Enregistre plusieurs appareils dans Pushwoosh en une seule requête. Elle permet également de spécifier divers tags pour chaque appareil.

POST https://api.pushwoosh.com/api/v2/audience/bulkRegisterDevice

Paramètres de la requête

Paramètre	Type	Requis	Description
application	string	Oui	Code d’application Pushwoosh
auth	string	Oui	Jeton d’accès API.
devices	array	Oui	Un tableau d’objets d’appareil. Chaque objet représente un appareil et ses données associées. Voir les détails dans le tableau Paramètres de l’objet appareil ci-dessous.

Paramètres de l’objet appareil

Paramètre	Type	Requis	Description
hwid	string	Oui	L’ID matériel (HWID) ou identifiant unique de l’appareil.
push_token	string	Oui	Jeton Push pour l’appareil.
platform	integer	Oui	L’identifiant de la plateforme. En savoir plus
list_operator	string	Non	Détermine l’action pour les tags de type liste : - “append” : Ajoute la valeur spécifiée à la liste de tags. - “remove” : Supprime la valeur spécifiée de la liste de tags. Remarque : Si le paramètre `list_operator` n’est pas spécifié, toutes les valeurs existantes dans la liste de tags seront remplacées par les valeurs fournies.
tags	object	Non	Tags personnalisés assignés à l’appareil. Les tags sont des paires clé-valeur utilisées pour la segmentation.

Exemple de requête

{
  "application": "code d'application",   // requis. Code d'application Pushwoosh
  "auth": "jeton d'authentification Pushwoosh",      // requis. Jeton d'accès API depuis le Control Panel de Pushwoosh
  "devices": [{                        // requis. Tableau d'appareils
    "hwid": "hwid de l'appareil",             // requis. Identifiant unique de l'appareil (peut être un e-mail).
    "push_token": "jeton push de l'appareil", // requis. Jeton de notification push pour l'appareil.
    "platform": 14,                    // requis. Plateforme de l'appareil (par ex., 14 pour l'e-mail).
    "list_operator": "append",         // optionnel. Pour les tags de liste. Ajoute ou supprime la ou les valeurs spécifiées du tag de type liste.
    "tags": {                          // optionnel. Valeurs à définir pour les tags spécifiés.
      "language": "en",                //           utiliser le type de valeur correct.
      "CSV_Import": "summer_camp"
    }
  },
  {
    "hwid": "hwid de l'appareil 2",           // requis. Identifiant unique du deuxième appareil.
    "push_token": "jeton push de l'appareil 2", // requis. Jeton de notification push pour l'appareil.
    "platform": 14,                    // requis. Plateforme de l'appareil.
    "list_operator": "remove",         // optionnel. Ajoute ou supprime des valeurs des tags de type liste.
    "tags": {                          // optionnel. Valeurs à supprimer des tags spécifiés.
      "language": "en",
      "CSV_Import": "summer_camp2"
    }
  },
  {
    "hwid": "hwid de l'appareil 3",           // requis. Identifiant unique du troisième appareil.
    "push_token": "jeton push de l'appareil 3", // requis. Jeton de notification push pour l'appareil.
    "platform": 14,                    // requis. Plateforme de l'appareil.
    "tags": {                          // optionnel. Valeurs à définir pour les tags spécifiés.
      "language": "en",
      "CSV_Import": "summer_camp3"
    }
  }]
}

Réponse

La méthode répond avec un ID d’opération, qui peut être utilisé pour suivre l’état et les résultats du processus d’enregistrement en masse.

{
  "request_id": "ID de requête à utiliser dans la méthode GET pour obtenir l'état de la tâche",
  "status": "Pending"
}

État de bulkRegisterDevice

Vous pouvez vérifier l’état d’un processus d’enregistrement en masse en effectuant la requête GET suivante :

GET https://api.pushwoosh.com/api/v2/audience/bulkRegisterDevice/{request_id}?detailed=true

Paramètre	Type	Requis	Description
request_id	string	Oui	L’ID de requête renvoyé par la requête POST.
detailed	boolean	Non	Si la valeur est `true`, la réponse inclut des résultats détaillés pour chaque appareil enregistré.

Exemple de réponse

{
  "request_id": "9a2e1a14-XXXX-46c3-XXXX-c254b25d3782",
  "status": "Completed",
  "progress": 100,
  "devices_success": 4,
  "devices": [
    {
      "hwid": "user1@example.com",
      "status": "done"
    },
    {
      "hwid": "user2@example.com",
      "status": "done"
    },
    {
      "hwid": "user3@example.com",
      "status": "done"
    },
    {
      "hwid": "invalid_email@example.com",
      "status": "failed"
    }
  ]
}

bulkUnregisterDevice

Désenregistre plusieurs appareils de Pushwoosh en une seule requête.

POST https://api.pushwoosh.com/api/v2/audience/bulkUnregisterDevice

Paramètres de la requête

Paramètre	Type	Requis	Description
application	string	Oui	Code d’application Pushwoosh
auth	string	Oui	Jeton d’accès API
devices	array	Oui	Un tableau d’objets d’appareil. Chaque objet représente un appareil et ses données associées. Voir les détails dans le tableau Paramètres de l’objet appareil ci-dessous.

Paramètres de l’objet appareil

Paramètre	Type	Requis	Description
hwid	string	Oui	L’ID matériel ou identifiant unique de l’appareil. En savoir plus

Exemple de requête

{
  "application": "code d'application",   // requis. Code d'application Pushwoosh
  "auth": "jeton d'authentification Pushwoosh",      // requis. Jeton d'accès API depuis le Control Panel de Pushwoosh
  "devices": [{                        // requis. Tableau d'appareils
    "hwid": "hwid de l'appareil",             // requis. Identifiant unique de l'appareil (peut être un e-mail).
  },
  {
    "hwid": "hwid de l'appareil 2",           // requis. Identifiant unique du deuxième appareil.
  },
  {
    "hwid": "hwid de l'appareil 3",           // requis. Identifiant unique du troisième appareil.
  }]
}

Réponse

La méthode répond avec un ID d’opération, qui peut être utilisé pour suivre l’état et les résultats du processus en masse.

{
  "request_id": "ID de requête à utiliser dans la méthode GET pour obtenir l'état de la tâche",
  "status": "Pending"
}

État de bulkUnregisterDevice

Vous pouvez vérifier l’état d’un processus de désenregistrement en masse en effectuant la requête GET suivante :

GET https://api.pushwoosh.com/api/v2/audience/bulkUnregisterDevice/{request_id}?detailed=true

Paramètre	Type	Requis	Description
request_id	string	Oui	L’ID de requête renvoyé par la requête POST.
detailed	boolean	Non	Si la valeur est `true`, la réponse inclut des résultats détaillés pour chaque appareil désenregistré.

Exemple de réponse

{
  "request_id": "9a2e1a14-XXXX-46c3-XXXX-c254b25d3782",
  "status": "Completed",
  "progress": 100,
  "devices_success": 4,
  "devices": [
    {
      "hwid": "user1@example.com",
      "status": "done"
    },
    {
      "hwid": "user2@example.com",
      "status": "done"
    },
    {
      "hwid": "user3@example.com",
      "status": "done"
    },
    {
      "hwid": "invalid_email@example.com",
      "status": "failed"
    }
  ]
}