API для управления пользователями

registerUser

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

Связывает внешний User ID с указанным устройством.

Заголовки запроса

Имя	Обязательный	Значение	Описание
Authorization	Да	Token `XXXX`	Device API token для доступа к Device API. Замените `XXXX` вашим фактическим Device API token.

Тело запроса

Имя	Тип	Описание
userId	string	User ID для связи с устройством. Если пусто, используется hwid.
application*	string	Код приложения Pushwoosh
hwid*	string	HWID Pushwoosh
tz_offset	integer	Смещение временной зоны для устройства в секундах.
device_type	integer	Тип устройства. Возможные значения см. в /registerDevice.

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

Может быть использован позже в вызове API /createMessage (параметр users).
Это нормально — вызывать эту функцию до того, как вы получите push-токен, и до вызова /registerDevice.

{
  "request": {
    "userId": "user_3078a",                     // необязательный. Если пусто, используется hwid
    "application": "XXXXX-XXXXX",               // обязательный. Код приложения Pushwoosh
    "hwid": "8f65b16df378e7a6bece9614e1530fb2", // обязательный. Аппаратный ID устройства (HWID)
    "tz_offset": -3600,                         // необязательный. Смещение временной зоны в секундах
    "device_type": 3                            // необязательный. Тип устройства, см. /registerDevice
                                                //           для типов устройств
  }
}

postEvent

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

Вызывает событие.

Заголовки запроса

Имя	Обязательный	Значение	Описание
Authorization	Да	Token `XXXX`	Device API token для доступа к Device API. Замените `XXXX` вашим фактическим Device API token.

Тело запроса

Имя	Тип	Описание
hwid*	string	Аппаратный ID устройства (HWID), используемый в запросе /registerDevice. Может использоваться вместе с ‘userId’ для идентификации пользователя, вызвавшего событие.
application*	string	Код приложения Pushwoosh
event*	string	Имя события в точности так, как оно создано в Панели управления Pushwoosh.
attributes*	object	Объект JSON с атрибутами события. Оставьте его пустым, если не нужно передавать атрибуты.
timestampUTC	integer	Временная метка в UTC.
timestampCurrent	integer	Временная метка в локальном времени.
userId*	string	User ID, связанный с пользователем, который вызвал событие. Может заменять HWID или использоваться вместе с ним.
device_type	integer	Возможные значения см. в методе /registerDevice.

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

Имя события в запросе должно соответствовать имени события в Панели управления Pushwoosh. Обратите внимание, что свойство “attributes” может быть пустым (но не отсутствовать), если событие не имеет атрибутов.

{
  "request":{
    "hwid": "8f65b16df378e7a6bece9614e1530fb2", // обязательный. Аппаратный ID устройства (HWID), используемый в /registerDevice API.
                                                //           Может использоваться вместе с userId для идентификации
                                                //           пользователя, который вызвал событие.
    "application": "XXXXX-XXXXX",               // обязательный. Код приложения Pushwoosh
    "event": "activityCompleted",               // обязательный. Имя события в точности так, как оно создано в Панели управления Pushwoosh
    "attributes": {                             // обязательный. Оставьте пустым, если не нужно передавать атрибуты.
      "login": "facebook",
      "success": "yes",
      "internet": "wifi",
    },
    "timestampUTC": 1435228403,                 // необязательный. Временная метка в UTC
    "timestampCurrent": 1435253603,             // необязательный. Временная метка в локальном времени
    "userId": "someuser@user.com",              // обязательный. ID пользователя, который используется для идентификации
                                                //           пользователей на нескольких устройствах. Может заменять
                                                //           или использоваться вместе с HWID.
    "device_type": 1                            // необязательный.
  }
}