# डिवाइस API

## registerDevice

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

SDK से आंतरिक रूप से कॉल किया जाता है। एप्लिकेशन के लिए डिवाइस पंजीकृत करता है।

##### अनुरोध हेडर

| नाम | आवश्यक | मान | विवरण |
|---------------|----------|---------------|------------------------------------------------------------|
| Authorization | हाँ | Token `XXXX` | डिवाइस API तक पहुंचने के लिए [API डिवाइस टोकन](/hi/developer/api-reference/api-access-token/#device-api-token)। `XXXX` को अपने वास्तविक डिवाइस API टोकन से बदलें। |


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

| नाम | प्रकार | विवरण |
| ---------------------------------------------- | ------- | --------------------------------------------------------------------------------------------------- |
| application\* | string | [Pushwoosh एप्लिकेशन कोड](/hi/developer/api-reference/api-identifiers/#application-code) |
| push\_token | string | डिवाइस के लिए [पुश टोकन](/hi/developer/api-reference/api-identifiers/#push-token)। |
| language | string | डिवाइस की भाषा लोकेल। ISO-639-1 मानक के अनुसार लोअरकेस दो-अक्षर का कोड होना चाहिए। |
| hwid\* | string | डिवाइस की पहचान करने के लिए अद्वितीय स्ट्रिंग (iOS पर IDFV, Android पर यादृच्छिक रूप से उत्पन्न मान)। [और जानें](/hi/developer/api-reference/api-identifiers/#hardware-id) |
| timezone | integer | डिवाइस के लिए सेकंड में टाइमज़ोन ऑफ़सेट। |
| device\_type\* | integer | [डिवाइस प्रकार](/hi/developer/api-reference/api-identifiers/#device-type)। नीचे संभावित मान देखें। |
| email | string | पंजीकृत करने के लिए ईमेल पता (HWID और पुश टोकन के बजाय ईमेल उपयोगकर्ताओं के लिए उपयोग करें)। |
| tags | object | पंजीकृत डिवाइस को असाइन करने के लिए टैग मान। |

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

```json title="उदाहरण"
{
  "request": {
    "application": "XXXXX-XXXXX",        // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "push_token": "dec301908b9ba8XXXXX57a58e40f96f5XXXXX2068674f5XXXXa25cdc250a2a41", // वैकल्पिक।
    "hwid": "1CA6XXXXX-8DAC-XXXXX-XXXXX-B756288B6D3C",                                   // आवश्यक। हार्डवेयर डिवाइस आईडी
    "idfa": "AEBE52E7-0XXXXX-455A-XXXXX-E57283966239",                                   // वैकल्पिक।
    "timezone": 3600,                    // वैकल्पिक। सेकंड में ऑफ़सेट
    "device_type": 1,                    // आवश्यक। नीचे संभावित मान देखें। ईमेल के लिए, 
                                         //           नीचे वर्णित "emails" पैरामीटर का उपयोग करें।
    "email": "email_address@domain.com", // अपने ईमेल प्रोजेक्ट के लिए ईमेल पता पंजीकृत करने के लिए "hwid" और "push_token" के बजाय उपयोग करें
    "language": "en",                    // वैकल्पिक। ISO 639-1|639-2 भाषा कोड
    "userId": "Alex",                    // वैकल्पिक।
    "tags": {                            // वैकल्पिक। पंजीकृत डिवाइस के लिए सेट किए जाने वाले टैग मान 
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"], // सूची प्रकार के टैग के लिए मानों की सूची सेट करता है
      "DateTag": "2024-10-02 22:11",     // ध्यान दें कि समय UTC में होना चाहिए
      "BooleanTag": true                 // मान्य मान हैं: true, false
    },

    // सिस्टम टैग, वैकल्पिक
    "app_version": "1.2.3", 
    "device_model": "Samsung SM-G355H",
    "os_version": "2.3",

    // क्रोम/फ़ायरफ़ॉक्स के लिए वैकल्पिक एन्क्रिप्शन कुंजियाँ
    "public_key": "BNmDO4BTKEMJqaqprTf7t/HBXXXXX/orcXXXXX/scS5CFP6XXXXXHI1/GgRQD8c4kTxTEEF0quvIUiLQqoBY0/Qo=",
    "auth_token": "RlRmCXXXXX/s7XXXXXjKFzoQ==",
 
    // क्रोम के लिए वैकल्पिक FCM कुंजियाँ (XMPP के लिए)
    "fcm_token": "BNmDO4BTKEMJXXXXXprTf7t/XXXXXBQ/orXXXXXc/scS5CFP6zhQGIHI1/GgRQD8c4kTxTEEF0quvIUiLQqoBY0/Qo=",
    "fcm_push_set": "RlXXXXXGM/s7XXXXXjKFzoQ=="
  }
}
```

संभावित डिवाइस प्रकार:

* 1 – iOS
* 3 – Android
* 7 – Mac OS X
* 8 – Windows
* 9 – Amazon
* 10 – Safari
* 11 – Chrome
* 12 – Firefox
* 13 – Internet Explorer
* 14 – Email
* 16 – Baidu Android
* 17 – Huawei
* 18 – SMS
* 20 – Web
* 21 – WhatsApp
* 22 – Line
* 23 – Kakao Talk
* 24 – Telegram
* 25 – Apple Wallet
* 26 – Google Wallet
* 27 – Viber

### ईमेल डिवाइस पंजीकृत करना
अपने ऐप के लिए **एक ईमेल सब्सक्राइबर को पंजीकृत करने** के लिए, अपने `/registerDevice` या [`/registerEmail`](/hi/developer/api-reference/email-api#registeremail) अनुरोध में `"email": "email_address@domain.com"` पैरामीटर इस प्रकार भेजें:

##### अनुरोध का उदाहरण
```json
{
  "request":{
    "application": "XXXXX-XXXXX",        // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "email": "email_address@domain.com", // आवश्यक। अपने ईमेल प्रोजेक्ट के लिए पंजीकृत करने के लिए ईमेल पता
    "language": "en",                    // वैकल्पिक। ISO 639-1|639-2 भाषा कोड
    "userId": "Alex",                    // वैकल्पिक।
    "tags": {                            // वैकल्पिक। पंजीकृत डिवाइस के लिए सेट किए जाने वाले टैग मान 
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"], // सूची प्रकार के टैग के लिए मानों की सूची सेट करता है
      "DateTag": "2024-10-02 22:11",     // ध्यान दें कि समय UTC में होना चाहिए
      "BooleanTag": true                 // मान्य मान हैं: true, false
    }
  }
}
```

### व्हाट्सएप डिवाइस पंजीकृत करना
अपने ऐप के लिए एक व्हाट्सएप डिवाइस पंजीकृत करने के लिए, इन दिशानिर्देशों का पालन करें:

- **hwid**: सुनिश्चित करें कि इस फ़ील्ड में `whatsapp:` उपसर्ग के बाद E.164 प्रारूप में फ़ोन नंबर शामिल है (उदाहरण के लिए, `whatsapp:+0000000000`)। फ़ोन नंबर मान्य होना चाहिए, जिसे Pushwoosh सत्यापित करेगा।

- **पुश टोकन**: एक पुश टोकन की आवश्यकता नहीं है, क्योंकि `hwid` स्वचालित रूप से पुश टोकन के रूप में कार्य करेगा।

- **device_type**: व्हाट्सएप को प्लेटफ़ॉर्म के रूप में निर्दिष्ट करने के लिए इस फ़ील्ड को 21 पर सेट करें।

##### अनुरोध का उदाहरण
```json
{ 
  "request": {
    "application": "XXXXX-XXXXX",        // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "hwid": "whatsapp:+0000000000",      // आवश्यक। व्हाट्सएप उपसर्ग और मान्य फ़ोन नंबर
    "timezone": 3600,                    // वैकल्पिक। सेकंड में समय ऑफ़सेट
    "device_type": 21,                   // आवश्यक। व्हाट्सएप डिवाइस प्रकार 21 है
    "language": "en",                    // वैकल्पिक। ISO 639-1|639-2 भाषा कोड
    "userId": "Alex",                    // वैकल्पिक। उपयोगकर्ता पहचानकर्ता
    "tags": {                            // वैकल्पिक। कस्टम सेगमेंटेशन के लिए टैग मान
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"],
      "DateTag": "2024-10-02 22:11",     // UTC प्रारूप
      "BooleanTag": true  
    },
    "app_version": "1.2.3",              // वैकल्पिक। एप्लिकेशन संस्करण
    "device_model": "Samsung SM-G355H",  // वैकल्पिक। डिवाइस मॉडल
    "os_version": "2.3"                  // वैकल्पिक। ऑपरेटिंग सिस्टम संस्करण
  }
}
```

### SMS डिवाइस पंजीकृत करना
अपने ऐप के लिए एक SMS डिवाइस पंजीकृत करने के लिए, इन दिशानिर्देशों का पालन करें:

- **hwid**: सुनिश्चित करें कि इस फ़ील्ड में E.164 प्रारूप में फ़ोन नंबर शामिल है (उदाहरण के लिए, `+0000000000`)। फ़ोन नंबर मान्य होना चाहिए, जिसे Pushwoosh सत्यापित करेगा।

- **पुश टोकन**: एक पुश टोकन की आवश्यकता नहीं है, क्योंकि `hwid` स्वचालित रूप से पुश टोकन के रूप में कार्य करेगा।

- **device_type**: SMS को प्लेटफ़ॉर्म के रूप में नामित करने के लिए इस आवश्यक फ़ील्ड को 18 पर सेट करें।

##### अनुरोध का उदाहरण
```json 
{  
   "request": {
      "application": "XXXXX-XXXXX",           // आवश्यक। Pushwoosh एप्लिकेशन कोड
      "hwid": "+0000000000",                  // आवश्यक। E.164 प्रारूप में मान्य फ़ोन नंबर
      "timezone": 3600,                       // वैकल्पिक। सेकंड में समय ऑफ़सेट
      "device_type": 18,                      // आवश्यक। SMS डिवाइस प्रकार 18 है
      "language": "en",                       // वैकल्पिक। ISO 639-1|639-2 भाषा कोड
      "userId": "Alex",                       // वैकल्पिक। उपयोगकर्ता पहचानकर्ता
      "tags": {                               // वैकल्पिक। कस्टम सेगमेंटेशन के लिए टैग मान
           "StringTag": "string value",
           "IntegerTag": 42,
           "ListTag": ["string1", "string2"],
           "DateTag": "2024-10-02 22:11",     // UTC प्रारूप
           "BooleanTag": true  
      },
      "app_version": "1.2.3",                 // वैकल्पिक। एप्लिकेशन संस्करण
      "device_model": "Samsung SM-G355H",     // वैकल्पिक। डिवाइस मॉडल
      "os_version": "2.3"                     // वैकल्पिक। ऑपरेटिंग सिस्टम संस्करण
   }
}
```

**स्टेटस कोड**:

| HTTP स्टेटस कोड | status\_code | विवरण |
| ---------------- | ------------ | -------------------------------------------------- |
| 200 | 200 | डिवाइस सफलतापूर्वक पंजीकृत हो गया |
| 200 | 210 | आर्गुमेंट त्रुटि। अधिक जानकारी के लिए status\_message देखें। |
| 400 | N/A | गलत प्रारूप वाला अनुरोध स्ट्रिंग |
| 500 | 500 | आंतरिक त्रुटि |



## unregisterDevice

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

डिवाइस का पुश टोकन हटाता है। अपंजीकृत डिवाइस अभी भी कुल डिवाइस में गिना जाता है और इन-ऐप्स के माध्यम से पहुंचा जा सकता है। SDK से आंतरिक रूप से कॉल किया जाता है।

##### अनुरोध हेडर

| नाम | आवश्यक | मान | विवरण |
|---------------|----------|---------------|------------------------------------------------------------|
| Authorization | हाँ | Token `XXXX` | डिवाइस API तक पहुंचने के लिए [API डिवाइस टोकन](/hi/developer/api-reference/api-access-token/#device-api-token)। `XXXX` को अपने वास्तविक डिवाइस API टोकन से बदलें। |

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

| नाम | प्रकार | विवरण |
| --------------------------------------------- | ------ | --------------------------------------------------- |
| application\* | string | [Pushwoosh एप्लिकेशन कोड](/hi/developer/api-reference/api-identifiers/#application-code) |
| hwid\* | string | /registerDevice अनुरोध में प्रयुक्त [हार्डवेयर डिवाइस आईडी](/hi/developer/api-reference/api-identifiers/#hardware-id)। |

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

```json title="उदाहरण"
{
  "request": {
    "application": "XXXXX-XXXXX",              // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "hwid": "8f65b16XXXXXe7a6beceXXXXX530fb2"  // आवश्यक। /registerDevice API में प्रयुक्त हार्डवेयर डिवाइस आईडी 
  }
}
```

<Aside type="note">
ईमेल के लिए [`/deleteEmail`](/hi/developer/api-reference/email-api/#deleteemail) पर कॉल करें।
</Aside>

**स्टेटस कोड**:

| HTTP स्टेटस कोड | status\_code | विवरण |
| ---------------- | ------------ | -------------------------------------------------- |
| 200 | 200 | डिवाइस सफलतापूर्वक अनसब्सक्राइब हो गया |
| 200 | 210 | आर्गुमेंट त्रुटि। अधिक जानकारी के लिए status\_message देखें। |
| 400 | N/A | गलत प्रारूप वाला अनुरोध स्ट्रिंग |
| 500 | 500 | आंतरिक त्रुटि |



## deleteDevice

`POST` `https://api.pushwoosh.com/api/v2/device-api/deleteDevice`

एप्लिकेशन के भीतर निर्दिष्ट [HWID](/hi/developer/api-reference/api-identifiers/#hardware-id) द्वारा पहचाने गए डिवाइस और उसके सभी संबंधित डेटा को हटाता है। [`/unregisterDevice`](/hi/developer/api-reference/device-api/#unregisterdevice) के विपरीत, जो केवल पुश टोकन को हटाता है और डिवाइस रिकॉर्ड को रखता है, `/deleteDevice` डिवाइस को पूरी तरह से हटा देता है। अनुरोध को एसिंक्रोनस रूप से संसाधित किया जाता है, और जैसे ही हटाने का अनुरोध प्रसंस्करण के लिए स्वीकार कर लिया जाता है, एंडपॉइंट `200 OK` लौटाता है।

#### अनुरोध हेडर

| नाम | आवश्यक | मान | विवरण |
|---------------|----------|------------------|------------------------------------------------------------|
| Authorization | हाँ | Token `XXXX` | डिवाइस API तक पहुंचने के लिए [API डिवाइस टोकन](/hi/developer/api-reference/api-access-token/#device-api-token)। `XXXX` को अपने वास्तविक डिवाइस API टोकन से बदलें। |
| Content-Type | हाँ | application/json | |

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

| नाम | आवश्यक | प्रकार | विवरण |
| ----------- | -------- | ------ | ----------------------------------------------------------------------------------------------------------- |
| application | हाँ | string | [Pushwoosh एप्लिकेशन कोड](/hi/developer/api-reference/api-identifiers/#application-code) |
| hwid | हाँ | string | हटाने के लिए डिवाइस का [हार्डवेयर डिवाइस आईडी](/hi/developer/api-reference/api-identifiers/#hardware-id)। |


#### अनुरोध का उदाहरण

```json
{
  "application": "XXXXX-XXXXX",                 // आवश्यक। Pushwoosh एप्लिकेशन कोड
  "hwid": "8f65b16df378e7a6bece9614e1530fb2"    // आवश्यक। हटाने के लिए डिवाइस का हार्डवेयर डिवाइस आईडी
}
```

#### प्रतिक्रिया का उदाहरण

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

##### स्टेटस कोड

| HTTP स्टेटस कोड | status\_code | विवरण |
| ---------------- | ------------ | -------------------------------------------------- |
| 200 | 200 | हटाने का अनुरोध स्वीकार किया गया |
| 200 | 210 | आर्गुमेंट त्रुटि। अधिक जानकारी के लिए status\_message देखें। |
| 400 | N/A | गलत प्रारूप वाला अनुरोध स्ट्रिंग |
| 401 | N/A | अनुपलब्ध या अमान्य प्राधिकरण टोकन |
| 500 | 500 | आंतरिक त्रुटि |



## setTags

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

डिवाइस के लिए टैग मान सेट करता है। SDK से कॉल किया जाता है।

##### अनुरोध हेडर

| नाम | आवश्यक | मान | विवरण |
|---------------|----------|---------------|------------------------------------------------------------|
| Authorization | हाँ | Token `XXXX` | डिवाइस API तक पहुंचने के लिए [API डिवाइस टोकन](/hi/developer/api-reference/api-access-token/#device-api-token)। `XXXX` को अपने वास्तविक डिवाइस API टोकन से बदलें। |

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

| नाम | प्रकार | विवरण |
| --------------------------------------------- | ------ | ------------------------------------------------------------ |
| application\* | string | [Pushwoosh एप्लिकेशन कोड](/hi/developer/api-reference/api-identifiers/#application-code) |
| hwid\* | string | /registerDevice अनुरोध में प्रयुक्त [हार्डवेयर डिवाइस आईडी](/hi/developer/api-reference/api-identifiers/#hardware-id)। |
| tags\* | object | सेट करने के लिए टैग का JSON ऑब्जेक्ट, मान को हटाने के लिए "null" भेजें। |

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

<Aside type="note">
यह विधि SDK से कॉल की जाती है। इसे आपके बैकएंड से दूरस्थ रूप से कॉल करना संभव है, हालांकि आपको बैकएंड साइड पर hwid का एक अद्यतित डेटाबेस बनाए रखना होगा।
</Aside>

```json title="उदाहरण"
{
  "request":{
    "application": "XXXXX-XXXXX",               // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "hwid": "8f65b16XXXXXe7a6becXXXXXe1530fb2", // आवश्यक। /registerDevice API में प्रयुक्त हार्डवेयर डिवाइस आईडी
    "tags": {                                   // आवश्यक।
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"],        // सूची प्रकार के टैग के लिए मानों की सूची सेट करता है
      "DateTag": "2024-10-02 22:11",            // ध्यान दें कि समय UTC में है
      "BooleanTag": true                        // मान्य मान हैं - true, false
    }  
  }
}
```

### इंटीजर टैग मान बढ़ाएँ

इंटीजर टैग के मान को **बढ़ाने** के लिए, "increment" मान के साथ `operation` पैरामीटर का उपयोग इस प्रकार करें:

```json
{
  "request":{
    "application": "12345-67890",                   // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "hwid": "21AB7628-XXXX-XXXX-CCC0-PO287CS24CA4", // आवश्यक। /registerDevice API में प्रयुक्त हार्डवेयर डिवाइस आईडी
    "tags": {                                       // आवश्यक।
      "Level": {                                    // टैग का नाम
        "operation": "increment",                   // निम्नलिखित मान की वृद्धि में इंटीजर टैग को ओवरराइट करता है 
        "value": 1                                  // टैग मान के लिए वृद्धि
      }  
    }  
  }
}
```

### इंटीजर टैग मान घटाएँ

**घटाने** के लिए, "increment" ऑपरेशन के मान के रूप में ऋणात्मक संख्याओं का उपयोग करें (-1, -2, -3,-n):

```json
{
  "request":{
    "application": "12345-67890",                   // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "hwid": "21AB7628-XXXX-XXXX-CCC0-PO287CS24CA4", // आवश्यक। /registerDevice API में प्रयुक्त हार्डवेयर डिवाइस आईडी
    "tags": {                                       // आवश्यक
      "Level": {                                    // टैग का नाम
        "operation": "increment",                   // निम्नलिखित मान की कमी में इंटीजर टैग को ओवरराइट करता है 
        "value": -1                                 // टैग मान के लिए कमी
      }  
    }  
  }
}
```

### सूची टैग मान जोड़ें

**सूची टैग को नए मानों के साथ विस्तारित करने** के लिए, "append" मान के साथ `operation` पैरामीटर का उपयोग इस प्रकार करें:

```json title="उदाहरण"
{
  "request": {
    "hwid": "3d124a79XXXXf189XXXX7dfd9XXXXafd", // आवश्यक। /registerDevice API में प्रयुक्त हार्डवेयर डिवाइस आईडी
    "application": "6XXXX-XXXX3",               // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "tags": {                                   // आवश्यक।
      "ListTag": {                              // टैग का नाम
        "operation": "append",                  // टैग की मानों की सूची में निम्नलिखित मान जोड़ता है
        "value": [                              // जोड़ने के लिए मान
          "tag2",
          "tag3"
        ]
      }
    }
  }
}
```

### सूची टैग मान हटाएँ

सूची टैग से कुछ मान हटाने के लिए, "remove" ऑपरेशन का उपयोग इस प्रकार करें:

```json
{
  "request":{
    "application": "12345-67890",                   // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "hwid": "21AB7628-XXXX-XXXX-CCC0-PO287CS24CA4", // आवश्यक। /registerDevice API में प्रयुक्त हार्डवेयर डिवाइस आईडी
    "tags": {                                       // आवश्यक।
      "In-App Product": {                           // टैग का नाम
        "operation": "remove",                      // सूची टैग से निम्नलिखित मान हटाता है
        "value": "outwear_02"                       // हटाने के लिए मान या मान
      }
    }  
  }
}
```

### UserID द्वारा टैग सेट करें

किसी विशेष [User ID](/hi/developer/api-reference/api-identifiers/#user-id) से जुड़े सभी डिवाइसों के लिए टैग सेट करने के लिए, "hwid" के बजाय "userId" पैरामीटर का उपयोग करें।

<Aside type="caution">
सुनिश्चित करें कि आप जिस टैग के लिए मान सेट कर रहे हैं वह [उपयोगकर्ता-विशिष्ट](/hi/developer/guides/audience-and-segmentation/tags/#tag-scope-general-vs-user-specific) है।
</Aside>

```json title="उदाहरण"
{
  "request":{
    "application": "AAAAA-BBBBB", // Pushwoosh ऐप कोड
    "userId": "some_user",        // उपयोगकर्ता आईडी जिसके लिए आप टैग सेट करना चाहते हैं 
    "tags": {                     // सेट करने के लिए टैग और मान
      "Language": "es"
    }  
  }
}
```

<Aside type="note">
ईमेल के लिए [`/setEmailTags`](/hi/developer/api-reference/email-api/#setemailtags) पर कॉल करें।
</Aside>

**स्टेटस कोड:**

| HTTP स्टेटस कोड | status\_code | विवरण |
| ---------------- | ------------ | -------------------------------------------------- |
| 200 | 200 | टैग सफलतापूर्वक सेट कर दिए गए हैं |
| 200 | 210 | आर्गुमेंट त्रुटि। अधिक जानकारी के लिए status\_message देखें। |
| 400 | N/A | गलत प्रारूप वाला अनुरोध स्ट्रिंग |
| 500 | 500 | आंतरिक त्रुटि |


## getTags

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

विशिष्ट डिवाइस के लिए संबंधित मानों के साथ टैग की एक सूची प्राप्त करता है।

##### अनुरोध हेडर

| नाम | आवश्यक | मान | विवरण |
|---------------|----------|---------------|------------------------------------------------------------|
| Authorization | हाँ | Token `XXXX` | डिवाइस API तक पहुंचने के लिए [API डिवाइस टोकन](/hi/developer/api-reference/api-access-token/#device-api-token)। `XXXX` को अपने वास्तविक डिवाइस API टोकन से बदलें। |

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

| नाम | प्रकार | विवरण |
| --------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------- |
| application\* | string | [Pushwoosh एप्लिकेशन कोड](/hi/developer/api-reference/api-identifiers/#application-code) |
| userId | string | [User ID](/hi/developer/api-reference/api-identifiers/#user-id) "hwid" के बजाय उपयोग किया जाना है। यदि "hwid" के साथ उपयोग किया जाता है, तो "hwid" प्रबल होता है। |
| hwid | string | `/registerDevice` अनुरोध में प्रयुक्त [हार्डवेयर डिवाइस आईडी](/hi/developer/api-reference/api-identifiers/#hardware-id)। |

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

```json title="उदाहरण"
{
  "request":{
    "application": "XXXXX-XXXXX",   // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "hwid": "HWID",                 // वैकल्पिक। /registerDevice API में प्रयुक्त हार्डवेयर डिवाइस आईडी
    "userId": "USER_ID"             // वैकल्पिक। किसी विशिष्ट उपयोगकर्ता के लिए टैग पुनर्प्राप्त करने के लिए "hwid" के बजाय उपयोग किया जा सकता है
  }
}
```

## setBadge

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

Pushwoosh को एक डिवाइस के लिए वर्तमान बैज मान भेजता है। SDK से आंतरिक रूप से कॉल किया जाता है।

##### अनुरोध हेडर

| नाम | आवश्यक | मान | विवरण |
|---------------|----------|---------------|------------------------------------------------------------|
| Authorization | हाँ | Token `XXXX` | डिवाइस API तक पहुंचने के लिए [API डिवाइस टोकन](/hi/developer/api-reference/api-access-token/#device-api-token)। `XXXX` को अपने वास्तविक डिवाइस API टोकन से बदलें। |

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

| नाम | प्रकार | विवरण |
| --------------------------------------------- | ------- | --------------------------------------------------- |
| application\* | string | [Pushwoosh एप्लिकेशन कोड](/hi/developer/api-reference/api-identifiers/#application-code) |
| hwid\* | string | /registerDevice अनुरोध में प्रयुक्त [हार्डवेयर डिवाइस आईडी](/hi/developer/api-reference/api-identifiers/#hardware-id)। |
| badge\* | integer | एप्लिकेशन पर वर्तमान बैज। |

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

```json title="उदाहरण"
{
  "request":{
    "application": "XXXXX-XXXXX",               // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "hwid": "8f65b16dXXXXe7a6XXXX9614XXXX0fb2", // आवश्यक। /registerDevice API में प्रयुक्त हार्डवेयर डिवाइस आईडी
    "badge": 4                                  // आवश्यक। एप्लिकेशन पर वर्तमान बैज
  }
}
```

SDK से आंतरिक रूप से कॉल किया जाता है। Pushwoosh को एक डिवाइस के लिए वर्तमान बैज मान भेजता है। यह आंतरिक रूप से तब होता है जब ऐप iOS डिवाइस पर बैज मान बदलता है। यह ऑटो-इन्क्रीमेंटिंग बैज को ठीक से काम करने की अनुमति देता है।

<Aside type="caution">
यह विधि डिवाइस पर बैज मान को अपडेट करने के लिए उपयोग **नहीं** की जाती है। इसके बजाय कृपया `"ios_badges"` पैरामीटर के साथ [`/createMessage`](/hi/developer/api-reference/messages-api/#createmessage) अनुरोध का उपयोग करें।
</Aside>



## applicationOpen

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

एक ऐप ओपन इवेंट पंजीकृत करता है। SDK से आंतरिक रूप से कॉल किया जाता है।

##### अनुरोध हेडर

| नाम | आवश्यक | मान | विवरण |
|---------------|----------|---------------|------------------------------------------------------------|
| Authorization | हाँ | Token `XXXX` | डिवाइस API तक पहुंचने के लिए [API डिवाइस टोकन](/hi/developer/api-reference/api-access-token/#device-api-token)। `XXXX` को अपने वास्तविक डिवाइस API टोकन से बदलें। |

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

| नाम | प्रकार | विवरण |
| --------------------------------------------- | ------ | --------------------------------------------------- |
| application\* | string | [Pushwoosh एप्लिकेशन कोड](/hi/developer/api-reference/api-identifiers/#application-code) |
| hwid\* | string | `/registerDevice` अनुरोध में प्रयुक्त [हार्डवेयर डिवाइस आईडी](/hi/developer/api-reference/api-identifiers/#hardware-id)। |

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

```json title="उदाहरण"
{
  "request": {
    "application": "XXXXX-XXXXX",              // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "hwid": "8f65b16dXXXXe7a6XXXX9614eXXXXfb2" // आवश्यक। /registerDevice API में प्रयुक्त हार्डवेयर डिवाइस आईडी    
  }
}
```



## pushStat

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

एक पुश ओपन इवेंट पंजीकृत करता है। SDK से आंतरिक रूप से कॉल किया जाता है।

##### अनुरोध हेडर

| नाम | आवश्यक | मान | विवरण |
|---------------|----------|---------------|------------------------------------------------------------|
| Authorization | हाँ | Token `XXXX` | डिवाइस API तक पहुंचने के लिए [API डिवाइस टोकन](/hi/developer/api-reference/api-access-token/#device-api-token)। `XXXX` को अपने वास्तविक डिवाइस API टोकन से बदलें। |
##### अनुरोध बॉडी

| नाम | प्रकार | विवरण |
| --------------------------------------------- | ------ | --------------------------------------------------------------------------- |
| application\* | string | [Pushwoosh एप्लिकेशन कोड](/hi/developer/api-reference/api-identifiers/#application-code) |
| hwid\* | string | /registerDevice अनुरोध में प्रयुक्त [हार्डवेयर डिवाइस आईडी](/hi/developer/api-reference/api-identifiers/#hardware-id)। |
| userId | string | पुश ओपन इवेंट के साथ संबद्ध करने के लिए [User ID](/hi/developer/api-reference/api-identifiers/#user-id)। |
| hash | string | पुश नोटिफिकेशन में प्राप्त हैश टैग (पुश पेलोड का "p" पैरामीटर)। |

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

```json title="उदाहरण"
{
  "request": {
    "application": "XXXXX-XXXXX",               // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "hwid": "8f65b16dfXXXX7a6beXXXX14e1530fb2", // आवश्यक। /registerDevice API में प्रयुक्त हार्डवेयर डिवाइस आईडी 
    "userId": "USER012345",                     // वैकल्पिक। पुश ओपन इवेंट के साथ संबद्ध करने के लिए उपयोगकर्ता आईडी 
    "hash": "HASH_TAG"                          // वैकल्पिक। पुश नोटिफिकेशन में प्राप्त हैश टैग
                                                //           ("p" पैरामीटर पुश पेलोड में)
  }
}
```


## messageDeliveryEvent

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

डिवाइस के लिए पुश डिलीवरी इवेंट पंजीकृत करता है। SDK से आंतरिक रूप से कॉल किया जाता है।

##### अनुरोध हेडर

| नाम | आवश्यक | मान | विवरण |
|---------------|----------|---------------|------------------------------------------------------------|
| Authorization | हाँ | Token `XXXX` | डिवाइस API तक पहुंचने के लिए [API डिवाइस टोकन](/hi/developer/api-reference/api-access-token/#device-api-token)। `XXXX` को अपने वास्तविक डिवाइस API टोकन से बदलें। |

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

| नाम | प्रकार | विवरण |
| --------------------------------------------- | ------ | --------------------------------------------------------------------------- |
| application\* | string | [Pushwoosh एप्लिकेशन कोड](/hi/developer/api-reference/api-identifiers/#application-code) |
| hwid\* | string | `/registerDevice` अनुरोध में प्रयुक्त [हार्डवेयर डिवाइस आईडी](/hi/developer/api-reference/api-identifiers/#hardware-id)। |
| hash | string | पुश नोटिफिकेशन में प्राप्त हैश टैग (पुश पेलोड का "p" पैरामीटर)। |

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

```json title="उदाहरण"
 {
  "request": {
    "application": "XXXXX-XXXXX",               // आवश्यक। Pushwoosh एप्लिकेशन कोड
    "hwid": "8f65b16dfXXXX7a6bece9XXXX1530fb2", // आवश्यक। /registerDevice API में प्रयुक्त हार्डवेयर डिवाइस आईडी
    "hash": "HASH_TAG"                          // वैकल्पिक। पुश नोटिफिकेशन में प्राप्त हैश टैग
                                                //           ("p" पैरामीटर पुश पेलोड में)
  }
}
```