API centrée sur l'utilisateur

registerUser

POST https://api.pushwoosh.com/json/1.3/registerUser

Associe un ID utilisateur externe à un appareil spécifié.

En-têtes de la requête

Nom	Requis	Valeur	Description
Authorization	Oui	Jeton `XXXX`	Jeton d’API d’appareil pour accéder à l’API d’appareil. Remplacez `XXXX` par votre véritable jeton d’API d’appareil.

Corps de la requête

Nom	Requis	Type	Description
userId	Non	string	ID utilisateur à associer à un appareil. S’il est vide, utilisez hwid.
application	Oui	string	Code d’application Pushwoosh
hwid	Oui	string	HWID Pushwoosh
tz_offset	Non	integer	Décalage de fuseau horaire en secondes pour l’appareil.
device_type	Non	integer	Type d’appareil. Voir les valeurs possibles dans `/registerDevice`.

Peut être utilisé plus tard dans l’appel API /createMessage (le paramètre users).
Vous pouvez appeler cette fonction avant d’avoir le jeton push et avant l’appel /registerDevice.

Exemple de requête

{
  "request": {
    "userId": "user_3078a",                     // facultatif. S'il est vide, utilisez hwid
    "application": "XXXXX-XXXXX",               // requis. Code d'application Pushwoosh
    "hwid": "8f65b16df378e7a6bece9614e1530fb2", // requis. ID matériel de l'appareil
    "tz_offset": -3600,                         // facultatif. Décalage de fuseau horaire en secondes
    "device_type": 3                            // facultatif. Type d'appareil, voir /registerDevice
                                                //           pour les types d'appareils
  }
}

Exemple de réponse

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

deleteUser

POST https://api.pushwoosh.com/api/v2/device-api/deleteUser

Supprime un utilisateur et tous les appareils associés à l’ID utilisateur spécifié au sein de l’application. La requête est traitée de manière asynchrone, et le point de terminaison renvoie 200 OK dès que la demande de suppression a été acceptée pour traitement.

En-têtes de la requête

Nom	Requis	Valeur	Description
Authorization	Oui	Jeton `XXXX`	Jeton d’API d’appareil pour accéder à l’API d’appareil. Remplacez `XXXX` par votre véritable jeton d’API d’appareil.
Content-Type	Oui	application/json

Corps de la requête

Nom	Requis	Type	Description
application	Oui	string	Code d’application Pushwoosh
user_id	Oui	string	ID utilisateur à supprimer. Tous les appareils associés à cet utilisateur dans l’application spécifiée seront supprimés.

Exemple de requête

{
  "application": "XXXXX-XXXXX",   // requis. Code d'application Pushwoosh
  "user_id": "user_3078a"         // requis. ID utilisateur à supprimer
}

Exemple de réponse

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

Codes de statut

Code de statut HTTP	status_code	Description
200	200	Demande de suppression acceptée
200	210	Erreur d’argument. Voir status_message pour plus d’informations.
400	N/A	Chaîne de requête malformée
401	N/A	Jeton d’autorisation manquant ou invalide
500	500	Erreur interne

postEvent

POST https://api.pushwoosh.com/json/1.3/postEvent

Déclenche un événement.

En-têtes de la requête

Nom	Requis	Valeur	Description
Authorization	Oui	Jeton `XXXX`	Jeton d’API d’appareil pour accéder à l’API d’appareil. Remplacez `XXXX` par votre véritable jeton d’API d’appareil.

Corps de la requête

Nom	Requis	Type	Description
hwid	Oui	string	ID matériel de l’appareil utilisé dans une requête /registerDevice. Peut être utilisé avec ‘userId’ pour identifier un utilisateur qui a déclenché un événement.
application	Oui	string	Code d’application Pushwoosh
event	Oui	string	Nom de l’événement tel que créé dans le Control Panel de Pushwoosh.
attributes	Oui	object	Objet JSON avec les attributs de l’événement. Laissez-le vide si aucun attribut ne doit être passé.
timestampUTC	Non	integer	Horodatage en UTC.
timestampCurrent	Non	integer	Horodatage en heure locale.
userId	Oui	string	ID utilisateur associé à un utilisateur qui a déclenché l’événement. Peut être remplacé par ou utilisé avec un HWID.
device_type	Non	integer	Voir les valeurs possibles

Le nom de l’événement dans la requête doit correspondre exactement au nom de l’événement dans le Control Panel de Pushwoosh. Notez que la propriété “attributes” peut être vide (mais pas omise) si l’événement n’a pas d’attributs.

Exemple de requête

{
  "request":{
    "hwid": "8f65b16df378e7a6bece9614e1530fb2", // requis. ID matériel de l'appareil utilisé dans une API /registerDevice.
                                                //           Peut être utilisé avec un userId pour identifier un
                                                //           utilisateur qui a déclenché un événement.
    "application": "XXXXX-XXXXX",               // requis. Code d'application Pushwoosh
    "event": "activityCompleted",               // requis. Nom de l'événement tel que créé dans le Control Panel de Pushwoosh
    "attributes": {                             // requis. Laissez vide si aucun attribut ne doit être passé.
      "login": "facebook",
      "success": "yes",
      "internet": "wifi"
    },
    "timestampUTC": 1435228403,                 // facultatif. Horodatage en UTC
    "timestampCurrent": 1435253603,             // facultatif. Horodatage en heure locale
    "userId": "someuser@user.com",              // requis. Un ID utilisateur qui est utilisé pour l'identification des
                                                //           utilisateurs sur plusieurs appareils. Peut être remplacé par
                                                //           ou utilisé avec un HWID.
    "device_type": 1                            // facultatif.
  }
}

Exemple de réponse

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "code": "61BC9-84DD0"
  }
}