API centrada en el usuario

registerUser

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

Asocia un ID de usuario externo con un dispositivo específico.

Encabezados de la solicitud

Nombre	Requerido	Valor	Descripción
Authorization	Sí	Token `XXXX`	Token de dispositivo de la API para acceder a la API de dispositivo. Reemplace `XXXX` con su token de API de dispositivo real.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Descripción
userId	No	string	ID de usuario para asociar con un dispositivo. Si está vacío, use hwid.
application	Sí	string	Código de aplicación de Pushwoosh
hwid	Sí	string	HWID de Pushwoosh
tz_offset	No	integer	Desplazamiento de la zona horaria en segundos para el dispositivo.
device_type	No	integer	Tipo de dispositivo. Vea los valores posibles en `/registerDevice`.

Se puede usar más tarde en la llamada a la API /createMessage (el parámetro users).
Puede llamar a esta función antes de tener el token push y antes de la llamada a /registerDevice.

Ejemplo de solicitud

{
  "request": {
    "userId": "user_3078a",                     // opcional. Si está vacío, use hwid
    "application": "XXXXX-XXXXX",               // requerido. Código de aplicación de Pushwoosh
    "hwid": "8f65b16df378e7a6bece9614e1530fb2", // requerido. ID de dispositivo de hardware
    "tz_offset": -3600,                         // opcional. Desplazamiento de la zona horaria en segundos
    "device_type": 3                            // opcional. Tipo de dispositivo, vea /registerDevice
                                                //           para tipos de dispositivo
  }
}

Ejemplo de respuesta

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

deleteUser

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

Elimina un usuario y todos los dispositivos asociados con el ID de usuario especificado dentro de la aplicación. La solicitud se procesa de forma asíncrona y el endpoint devuelve 200 OK tan pronto como la solicitud de eliminación ha sido aceptada para su procesamiento.

Encabezados de la solicitud

Nombre	Requerido	Valor	Descripción
Authorization	Sí	Token `XXXX`	Token de dispositivo de la API para acceder a la API de dispositivo. Reemplace `XXXX` con su token de API de dispositivo real.
Content-Type	Sí	application/json

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Descripción
application	Sí	string	Código de aplicación de Pushwoosh
user_id	Sí	string	ID de usuario a eliminar. Se eliminarán todos los dispositivos asociados con este usuario en la aplicación especificada.

Ejemplo de solicitud

{
  "application": "XXXXX-XXXXX",   // requerido. Código de aplicación de Pushwoosh
  "user_id": "user_3078a"         // requerido. ID de usuario a eliminar
}

Ejemplo de respuesta

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

Códigos de estado

Código de estado HTTP	status_code	Descripción
200	200	Solicitud de eliminación aceptada
200	210	Error de argumento. Vea status_message para más información.
400	N/A	Cadena de solicitud mal formada
401	N/A	Token de autorización faltante o inválido
500	500	Error interno

postEvent

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

Desencadena un evento.

Encabezados de la solicitud

Nombre	Requerido	Valor	Descripción
Authorization	Sí	Token `XXXX`	Token de dispositivo de la API para acceder a la API de dispositivo. Reemplace `XXXX` con su token de API de dispositivo real.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Descripción
hwid	Sí	string	ID de dispositivo de hardware utilizado en una solicitud /registerDevice. Se puede usar junto con ‘userId’ para identificar a un usuario que ha desencadenado un evento.
application	Sí	string	Código de aplicación de Pushwoosh
event	Sí	string	Nombre del evento exactamente como se creó en el Panel de Control de Pushwoosh.
attributes	Sí	object	Objeto JSON con los atributos del evento. Déjelo vacío si no es necesario pasar atributos.
timestampUTC	No	integer	Marca de tiempo en UTC.
timestampCurrent	No	integer	Marca de tiempo en hora local.
userId	Sí	string	ID de usuario asociado con un usuario que ha desencadenado el evento. Puede ser reemplazado por o usado junto con un HWID.
device_type	No	integer	Vea los valores posibles

El nombre del evento en la solicitud debe coincidir con el nombre del evento en el Panel de Control de Pushwoosh. Tenga en cuenta que la propiedad “attributes” puede estar vacía (pero no omitida) en caso de que el evento no tenga atributos.

Ejemplo de solicitud

{
  "request":{
    "hwid": "8f65b16df378e7a6bece9614e1530fb2", // requerido. ID de dispositivo de hardware utilizado en una API /registerDevice.
                                                //           Se puede usar junto con un userId para identificar a
                                                //           un usuario que ha desencadenado un evento.
    "application": "XXXXX-XXXXX",               // requerido. Código de aplicación de Pushwoosh
    "event": "activityCompleted",               // requerido. Nombre del evento exactamente como se creó en el Panel de Control de Pushwoosh
    "attributes": {                             // requerido. Dejar vacío si no es necesario pasar atributos.
      "login": "facebook",
      "success": "yes",
      "internet": "wifi"
    },
    "timestampUTC": 1435228403,                 // opcional. Marca de tiempo en UTC
    "timestampCurrent": 1435253603,             // opcional. Marca de tiempo en hora local
    "userId": "someuser@user.com",              // requerido. Un id de usuario que se utiliza para la identificación de
                                                //           usuarios en múltiples dispositivos. Puede ser reemplazado por
                                                //           o usado junto con un HWID.
    "device_type": 1                            // opcional.
  }
}

Ejemplo de respuesta

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