# टैग्स API

<Aside type="note">
HWID और UserID के लिए टैग मान सेट करने के लिए, डिवाइस API से [/setTags](/hi/developer/api-reference/device-api#settags) विधि का उपयोग करें।
</Aside>

## addTag

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

आपके खाते में एक टैग बनाता है।

#### अनुरोध बॉडी

| नाम                                       | प्रकार    | विवरण                                                                                              |
| ------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------- |
| auth\*     | string  | Pushwoosh कंट्रोल पैनल से [API एक्सेस टोकन](/hi/developer/api-reference/api-identifiers/#api-access-token)।                                                           |
| tag\*      | object  | टैग पैरामीटर।                                                                                          |
| tag.name\* | string  | टैग का नाम।                                                                                                |
| tag.type\* | integer | टैग का प्रकार। नीचे संभावित मान देखें।                                                                     |
| tag.user\_specific | boolean | जब `true` होता है, तो टैग मान उपयोगकर्ता स्तर पर संग्रहीत होता है और UserID द्वारा सेट किए जाने पर उपयोगकर्ता के सभी डिवाइसों में साझा किया जाता है। जब `false` (डिफ़ॉल्ट) होता है, तो टैग डिवाइस-स्तरीय होता है और प्रति HWID सेट किया जाता है। |

<Tabs>
<TabItem label="200">
```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "result": true
  }
}
```
</TabItem>
</Tabs>



```json title="उदाहरण"
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // आवश्यक। Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन
    "tag": {
      "name": "TAG_NAME",           // आवश्यक।
      "type": 1,                    // आवश्यक। नीचे संभावित मान देखें
      "user_specific": false        // वैकल्पिक। true = उपयोगकर्ता-स्तरीय टैग (सभी डिवाइसों में साझा); false = डिवाइस-स्तरीय टैग (डिफ़ॉल्ट)
    }
  }
}
```

**संभावित टैग मान प्रकार:**

* 1 - पूर्णांक
* 2 - स्ट्रिंग
* 3 - सूची
* 4 - दिनांक
* 5 - बूलियन
* 6 - दशमलव। उदाहरण: 19.95
* 7 - संस्करण। उदाहरण: "1.0.0.0"



## deleteTag

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

डेटाबेस से सभी संबंधित जानकारी के साथ एक टैग को पूरी तरह से हटा देता है।

#### अनुरोध बॉडी

| नाम                                       | प्रकार   | विवरण                                    |
| ------------------------------------------ | ------ | ---------------------------------------------- |
| auth\*     | string | Pushwoosh कंट्रोल पैनल से [API एक्सेस टोकन](/hi/developer/api-reference/api-identifiers/#api-access-token)। |
| tag\*      | object | टैग पैरामीटर।                                |
| tag.name\* | string | हटाने के लिए [टैग](/hi/developer/api-reference/api-identifiers/#tag) का नाम।                       |

<Tabs>
<TabItem label="200">
```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "result": true
  }
}
```
</TabItem>
</Tabs>



```json title="उदाहरण"
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // आवश्यक। Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन
    "tag": {
      "name": "TAG_NAME"            // आवश्यक। हटाने के लिए टैग का नाम
    }
  }
}


```

## listTags

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

खाते पर टैग की एक सूची प्राप्त करता है।

#### अनुरोध बॉडी

| नाम                                   | प्रकार   | विवरण                                    |
| -------------------------------------- | ------ | ---------------------------------------------- |
| auth\* | string | Pushwoosh कंट्रोल पैनल से [API एक्सेस टोकन](/hi/developer/api-reference/api-identifiers/#api-access-token)। |

<Tabs>
<TabItem label="200">
```json
{
  "status_code": 200,
  "status_message": "OK", 
  "response": {
    "tags": [{
      "name":"Language",
      "type":2
    }, {
      "name":"List tag",
      "type":3
    }]
  }
}
```
</TabItem>
</Tabs>



```json title="उदाहरण"
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H" // Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन
  }
} 
```

**टैग प्रकार**:

* 1 - पूर्णांक
* 2 - स्ट्रिंग
* 3 - सूची
* 4 - दिनांक
* 5 - बूलियन
* 6 - दशमलव। उदाहरण: 19.95
* 7 - संस्करण। उदाहरण: "1.0.0.0"