API de Tags

Para establecer valores de tags para HWIDs y UserIDs, utiliza el método /setTags de la API de Dispositivos. addTag es opcional, porque setTags crea cualquier nombre de tag que aún no reconoce e infiere el tipo a partir del valor: un número entero se convierte en Integer, un número con punto decimal se convierte en Price, una cadena de texto se convierte en String (o Date, para un formato de fecha y hora reconocido como 2024-10-02 22:11), un array se convierte en List, y un booleano se convierte en Boolean. Un tag creado automáticamente siempre es User-specific (user_specific: true). Usa addTag para un tag de tipo Version, ya que la creación automática no puede inferirlo, o para un tag General (user_specific: false). La creación automática de tags está habilitada por defecto para la gran mayoría de las cuentas. Si setTags no crea un nuevo tag como se espera, contacta con el Soporte de Pushwoosh para verificar si ha sido desactivado para tu cuenta.

Para almacenar datos estructurados, como un pedido o una lista de pedidos, en un solo tag, usa los tags de objeto (beta). addTag no puede crearlos, porque no admite campos.

addTag

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

Crea un tag en tu cuenta.

Cuerpo de la solicitud

Nombre	Tipo	Descripción
auth*	string	Token de acceso a la API desde el Panel de Control de Pushwoosh.
tag*	object	Parámetros del tag.
tag.name*	string	Nombre del tag.
tag.type*	integer	Tipo de tag. Ver los valores posibles a continuación.
tag.user_specific	boolean	Cuando es `true`, el valor del tag se almacena a nivel de usuario y se comparte entre todos los dispositivos de un usuario cuando se establece por UserID. Cuando es `false` (por defecto), el tag es a nivel de dispositivo y se establece por HWID.
tag.application_specific	boolean	Obsoleto. Se acepta, pero se ignora, porque los tags ya no se dividen en específicos de la aplicación y de toda la cuenta. Puede omitirlo.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "result": true
  }
}

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // required. API access token from Pushwoosh Control Panel
    "tag": {
      "name": "TAG_NAME",           // required.
      "type": 1,                    // required. See possible values below
      "user_specific": false        // optional. true = user-level tag (shared across all devices); false = device-level tag (default)
    }
  }
}

Posibles tipos de valor de tag:

1 - Integer
2 - String
3 - List
4 - Date
5 - Boolean
6 - Decimal. Ej: 19.95
7 - Version. Ej: “1.0.0.0”

deleteTag

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

Elimina completamente un tag con toda la información asociada de la base de datos.

Cuerpo de la solicitud

Nombre	Tipo	Descripción
auth*	string	Token de acceso a la API desde el Panel de Control de Pushwoosh.
tag*	object	Parámetros del tag.
tag.name*	string	Nombre de un tag para eliminar.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "result": true
  }
}

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // required. API access token from Pushwoosh Control Panel
    "tag": {
      "name": "TAG_NAME"            // required. Name of a tag to delete
    }
  }
}

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

Recupera una lista de tags de la cuenta.

Cuerpo de la solicitud

Nombre	Tipo	Descripción
auth*	string	Token de acceso a la API desde el Panel de Control de Pushwoosh.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "tags": [{
      "name":"Language",
      "type":2,
      "isUserSpecific":true,
      "isApplicationSpecific":true
    }, {
      "name":"List tag",
      "type":3,
      "isUserSpecific":false,
      "isApplicationSpecific":true
    }]
  }
}

isUserSpecific indica si el tag es User-specific. isApplicationSpecific siempre es true y se mantiene solo por compatibilidad con versiones anteriores, porque los tags ya no se dividen en específicos de la aplicación y de toda la cuenta. No dependa de este campo.

{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H" // API access token from Pushwoosh Control Panel
  }
}

Tipos de tag:

1 - Integer
2 - String
3 - List
4 - Date
5 - Boolean
6 - Decimal. Ej: 19.95
7 - Version. Ej: “1.0.0.0”