# Device-API

## registerDevice

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

Wird intern vom SDK aufgerufen. Registriert das Gerät für die Anwendung.

##### Anfrage-Header

| Name | Erforderlich | Wert | Beschreibung |
|---|---|---|---|
| Authorization | Ja | Token `XXXX` | [API-Device-Token](/de/developer/api-reference/api-access-token/#device-api-token) für den Zugriff auf die Device-API. Ersetzen Sie `XXXX` durch Ihr tatsächliches Device-API-Token. |


##### Anfrage-Body

| Name | Typ | Beschreibung |
| --- | --- | --- |
| application\* | string | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) |
| push\_token | string | [Push-Token](/de/developer/api-reference/api-identifiers/#push-token) für das Gerät. |
| language | string | Sprach-Locale des Geräts. Muss ein zweibuchstabiger Kleinbuchstabencode gemäß dem ISO-639-1-Standard sein. |
| hwid\* | string | Eindeutige Zeichenfolge zur Identifizierung des Geräts (IDFV bei iOS, zufällig generierter Wert bei Android). [Mehr erfahren](/de/developer/api-reference/api-identifiers/#hardware-id) |
| timezone | integer | Zeitzonen-Offset in Sekunden für das Gerät. |
| device\_type\* | integer | [Gerätetyp](/de/developer/api-reference/api-identifiers/#device-type). Siehe mögliche Werte unten. |
| email | string | E-Mail-Adresse zur Registrierung (anstelle von HWID und Push-Token für E-Mail-Benutzer verwenden). |
| tags | object | Tag-Werte, die dem registrierten Gerät zugewiesen werden sollen. |

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

```json title="Beispiel"
{
  "request": {
    "application": "XXXXX-XXXXX",        // erforderlich. Pushwoosh-Anwendungscode
    "push_token": "dec301908b9ba8XXXXX57a58e40f96f5XXXXX2068674f5XXXXa25cdc250a2a41", // optional.
    "hwid": "1CA6XXXXX-8DAC-XXXXX-XXXXX-B756288B6D3C",                                   // erforderlich. Hardware-Geräte-ID
    "idfa": "AEBE52E7-0XXXXX-455A-XXXXX-E57283966239",                                   // optional.
    "timezone": 3600,                    // optional. Offset in Sekunden
    "device_type": 1,                    // erforderlich. Siehe die möglichen Werte unten. Für E-Mails, 
                                         //           verwenden Sie die "emails"-Parameter wie unten beschrieben.
    "email": "email_address@domain.com", // anstelle von "hwid" und "push_token" verwenden, um
                                         //           die E-Mail-Adresse für Ihr E-Mail-Projekt zu registrieren
    "language": "en",                    // optional. ISO 639-1|639-2 Sprachcode
    "userId": "Alex",                    // optional.
    "tags": {                            // optional. Tag-Werte, die für das registrierte Gerät festgelegt werden sollen 
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"], // setzt die Liste der Werte für Tags vom Typ Liste
      "DateTag": "2024-10-02 22:11",     // beachten Sie, dass die Zeit in UTC sein sollte
      "BooleanTag": true                 // gültige Werte sind: true, false
    },

    // System-Tags, optional
    "app_version": "1.2.3", 
    "device_model": "Samsung SM-G355H",
    "os_version": "2.3",

    // optionale Verschlüsselungsschlüssel für Chrome/Firefox
    "public_key": "BNmDO4BTKEMJqaqprTf7t/HBXXXXX/orcXXXXX/scS5CFP6XXXXXHI1/GgRQD8c4kTxTEEF0quvIUiLQqoBY0/Qo=",
    "auth_token": "RlRmCXXXXX/s7XXXXXjKFzoQ==",
 
    // optionale FCM-Schlüssel für Chrome (für XMPP)
    "fcm_token": "BNmDO4BTKEMJXXXXXprTf7t/XXXXXBQ/orXXXXXc/scS5CFP6zhQGIHI1/GgRQD8c4kTxTEEF0quvIUiLQqoBY0/Qo=",
    "fcm_push_set": "RlXXXXXGM/s7XXXXXjKFzoQ=="
  }
}
```

Mögliche Gerätetypen:

* 1 – iOS
* 3 – Android
* 7 – Mac OS X
* 8 – Windows
* 9 – Amazon
* 10 – Safari
* 11 – Chrome
* 12 – Firefox
* 13 – Internet Explorer
* 14 – E-Mail
* 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

### Registrierung von E-Mail-Geräten
Um **einen E-Mail-Abonnenten** für Ihre App zu registrieren, senden Sie den Parameter `"email": "email_address@domain.com"` in Ihrer `/registerDevice`- oder [`/registerEmail`](/de/developer/api-reference/email-api#registeremail)-Anfrage wie folgt:

##### Anfragebeispiel
```json
{
  "request":{
    "application": "XXXXX-XXXXX",        // erforderlich. Pushwoosh-Anwendungscode
    "email": "email_address@domain.com", // erforderlich. E-Mail-Adresse zur Registrierung für Ihr E-Mail-Projekt
    "language": "en",                    // optional. ISO 639-1|639-2 Sprachcode
    "userId": "Alex",                    // optional.
    "tags": {                            // optional. Tag-Werte, die für das registrierte Gerät festgelegt werden sollen 
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"], // setzt die Liste der Werte für Tags vom Typ Liste
      "DateTag": "2024-10-02 22:11",     // beachten Sie, dass die Zeit in UTC sein sollte
      "BooleanTag": true                 // gültige Werte sind: true, false
    }
  }
}
```

### Registrierung von WhatsApp-Geräten
Um ein WhatsApp-Gerät für Ihre App zu registrieren, befolgen Sie diese Richtlinien:

- **hwid**: Stellen Sie sicher, dass dieses Feld das Präfix `whatsapp:` gefolgt von der Telefonnummer im E.164-Format enthält (z. B. `whatsapp:+0000000000`). Die Telefonnummer muss gültig sein, was Pushwoosh überprüfen wird.

- **Push-Token**: Ein Push-Token ist nicht erforderlich, da die `hwid` automatisch als Push-Token fungiert.

- **device_type**: Setzen Sie dieses Feld auf `21`, um WhatsApp als Plattform anzugeben.

##### Anfragebeispiel
```json
{ 
  "request": {
    "application": "XXXXX-XXXXX",        // erforderlich. Pushwoosh-Anwendungscode
    "hwid": "whatsapp:+0000000000",      // erforderlich. WhatsApp-Präfix und gültige Telefonnummer
    "timezone": 3600,                    // optional. Zeitversatz in Sekunden
    "device_type": 21,                   // erforderlich. WhatsApp-Gerätetyp ist 21
    "language": "en",                    // optional. ISO 639-1|639-2 Sprachcode
    "userId": "Alex",                    // optional. Benutzerkennung
    "tags": {                            // optional. Tag-Werte für benutzerdefinierte Segmentierung
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"],
      "DateTag": "2024-10-02 22:11",     // UTC-Format
      "BooleanTag": true  
    },
    "app_version": "1.2.3",              // optional. Anwendungsversion
    "device_model": "Samsung SM-G355H",  // optional. Gerätemodell
    "os_version": "2.3"                  // optional. Betriebssystemversion
  }
}
```

### Registrierung von SMS-Geräten
Um ein SMS-Gerät für Ihre App zu registrieren, befolgen Sie diese Richtlinien:

- **hwid**: Stellen Sie sicher, dass dieses Feld die Telefonnummer im E.164-Format enthält (z. B. `+0000000000`). Die Telefonnummer muss gültig sein, was Pushwoosh überprüfen wird.

- **Push-Token**: Ein Push-Token ist nicht erforderlich, da die `hwid` automatisch als Push-Token fungiert.

- **device_type**: Setzen Sie dieses erforderliche Feld auf `18`, um SMS als Plattform zu bestimmen.

##### Anfragebeispiel
```json 
{  
   "request": {
      "application": "XXXXX-XXXXX",           // erforderlich. Pushwoosh-Anwendungscode
      "hwid": "+0000000000",                  // erforderlich. Gültige Telefonnummer im E.164-Format
      "timezone": 3600,                       // optional. Zeitversatz in Sekunden
      "device_type": 18,                      // erforderlich. SMS-Gerätetyp ist 18
      "language": "en",                       // optional. ISO 639-1|639-2 Sprachcode
      "userId": "Alex",                       // optional. Benutzerkennung
      "tags": {                               // optional. Tag-Werte für benutzerdefinierte Segmentierung
           "StringTag": "string value",
           "IntegerTag": 42,
           "ListTag": ["string1", "string2"],
           "DateTag": "2024-10-02 22:11",     // UTC-Format
           "BooleanTag": true  
      },
      "app_version": "1.2.3",                 // optional. Anwendungsversion
      "device_model": "Samsung SM-G355H",     // optional. Gerätemodell
      "os_version": "2.3"                     // optional. Betriebssystemversion
   }
}
```

**Status-Codes**:

| HTTP-Statuscode | status\_code | Beschreibung |
|---|---|---|
| 200 | 200 | Gerät erfolgreich registriert |
| 200 | 210 | Argumentfehler. Siehe `status_message` für weitere Informationen. |
| 400 | N/A | Fehlerhafte Anforderungszeichenfolge |
| 500 | 500 | Interner Fehler |



## unregisterDevice

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

Entfernt das Push-Token des Geräts. Das abgemeldete Gerät wird weiterhin in den Gesamtgeräten gezählt und kann mit In-Apps erreicht werden. Wird intern vom SDK aufgerufen.

##### Anfrage-Header

| Name | Erforderlich | Wert | Beschreibung |
|---|---|---|---|
| Authorization | Ja | Token `XXXX` | [API-Device-Token](/de/developer/api-reference/api-access-token/#device-api-token) für den Zugriff auf die Device-API. Ersetzen Sie `XXXX` durch Ihr tatsächliches Device-API-Token. |

##### Anfrage-Body

| Name | Typ | Beschreibung |
| --- | --- | --- |
| application\* | string | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) |
| hwid\* | string | [Hardware-Geräte-ID](/de/developer/api-reference/api-identifiers/#hardware-id), die in der `/registerDevice`-Anfrage verwendet wird. |

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

```json title="Beispiel"
{
  "request": {
    "application": "XXXXX-XXXXX",              // erforderlich. Pushwoosh-Anwendungscode
    "hwid": "8f65b16XXXXXe7a6beceXXXXX530fb2"  // erforderlich. Hardware-Geräte-ID, die in der /registerDevice-API verwendet wird 
  }
}
```

<Aside type="note">
Für E-Mails rufen Sie [`/deleteEmail`](/de/developer/api-reference/email-api/#deleteemail) auf.
</Aside>

**Status-Codes**:

| HTTP-Statuscode | status\_code | Beschreibung |
|---|---|---|
| 200 | 200 | Gerät erfolgreich abgemeldet |
| 200 | 210 | Argumentfehler. Siehe `status_message` für weitere Informationen. |
| 400 | N/A | Fehlerhafte Anforderungszeichenfolge |
| 500 | 500 | Interner Fehler |



## deleteDevice

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

Löscht ein Gerät und alle zugehörigen Daten, die durch die angegebene [HWID](/de/developer/api-reference/api-identifiers/#hardware-id) innerhalb der Anwendung identifiziert werden. Im Gegensatz zu [`/unregisterDevice`](/de/developer/api-reference/device-api/#unregisterdevice), das nur das Push-Token entfernt und den Gerätedatensatz beibehält, entfernt `/deleteDevice` das Gerät vollständig. Die Anfrage wird asynchron verarbeitet, und der Endpunkt gibt `200 OK` zurück, sobald die Löschanfrage zur Verarbeitung angenommen wurde.

#### Anfrage-Header

| Name | Erforderlich | Wert | Beschreibung |
|---|---|---|---|
| Authorization | Ja | Token `XXXX` | [API-Device-Token](/de/developer/api-reference/api-access-token/#device-api-token) für den Zugriff auf die Device-API. Ersetzen Sie `XXXX` durch Ihr tatsächliches Device-API-Token. |
| Content-Type | Ja | application/json | |

#### Anfrage-Body

| Name | Erforderlich | Typ | Beschreibung |
| --- | --- | --- | --- |
| application | Ja | string | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) |
| hwid | Ja | string | [Hardware-Geräte-ID](/de/developer/api-reference/api-identifiers/#hardware-id) des zu löschenden Geräts. |


#### Anfragebeispiel

```json
{
  "application": "XXXXX-XXXXX",                 // erforderlich. Pushwoosh-Anwendungscode
  "hwid": "8f65b16df378e7a6bece9614e1530fb2"    // erforderlich. Hardware-Geräte-ID des zu löschenden Geräts
}
```

#### Antwortbeispiel

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

##### Status-Codes

| HTTP-Statuscode | status\_code | Beschreibung |
|---|---|---|
| 200 | 200 | Löschanfrage akzeptiert |
| 200 | 210 | Argumentfehler. Siehe `status_message` für weitere Informationen. |
| 400 | N/A | Fehlerhafte Anforderungszeichenfolge |
| 401 | N/A | Fehlendes oder ungültiges Authorization-Token |
| 500 | 500 | Interner Fehler |



## setTags

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

Setzt Tag-Werte für das Gerät. Wird vom SDK aufgerufen.

##### Anfrage-Header

| Name | Erforderlich | Wert | Beschreibung |
|---|---|---|---|
| Authorization | Ja | Token `XXXX` | [API-Device-Token](/de/developer/api-reference/api-access-token/#device-api-token) für den Zugriff auf die Device-API. Ersetzen Sie `XXXX` durch Ihr tatsächliches Device-API-Token. |

##### Anfrage-Body

| Name | Typ | Beschreibung |
| --- | --- | --- |
| application\* | string | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) |
| hwid\* | string | [Hardware-Geräte-ID](/de/developer/api-reference/api-identifiers/#hardware-id), die in der `/registerDevice`-Anfrage verwendet wird. |
| tags\* | object | JSON-Objekt der zu setzenden Tags, senden Sie "null", um den Wert zu entfernen. |

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

<Aside type="note">
Die Methode wird vom SDK aufgerufen. Es ist möglich, sie remote von Ihrem Backend aus aufzurufen, jedoch müssen Sie eine aktuelle Datenbank von hwid’s auf der Backend-Seite pflegen.
</Aside>

```json title="Beispiel"
{
  "request":{
    "application": "XXXXX-XXXXX",               // erforderlich. Pushwoosh-Anwendungscode
    "hwid": "8f65b16XXXXXe7a6becXXXXXe1530fb2", // erforderlich. Hardware-Geräte-ID, die in der /registerDevice-API verwendet wird
    "tags": {                                   // erforderlich.
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"],        // setzt die Liste der Werte für Tags vom Typ Liste
      "DateTag": "2024-10-02 22:11",            // beachten Sie, dass die Zeit in UTC ist
      "BooleanTag": true                        // gültige Werte sind - true, false
    }  
  }
}
```

### Integer-Tag-Werte inkrementieren

Um einen Wert des Integer-Tags zu **inkrementieren**, verwenden Sie den `operation`-Parameter mit dem Wert "increment" wie folgt:

```json
{
  "request":{
    "application": "12345-67890",                   // erforderlich. Pushwoosh-Anwendungscode
    "hwid": "21AB7628-XXXX-XXXX-CCC0-PO287CS24CA4", // erforderlich. Hardware-Geräte-ID, die in der /registerDevice-API verwendet wird
    "tags": {                                       // erforderlich.
      "Level": {                                    // Tag-Name
        "operation": "increment",                   // überschreibt das Integer-Tag in Inkrementen des folgenden Wertes 
        "value": 1                                  // Inkrement für den Tag-Wert
      }  
    }  
  }
}
```

### Integer-Tag-Werte dekrementieren

Um zu **dekrementieren**, verwenden Sie negative Zahlen als Wert für die "increment"-Operation (-1, -2, -3, -n):

```json
{
  "request":{
    "application": "12345-67890",                   // erforderlich. Pushwoosh-Anwendungscode
    "hwid": "21AB7628-XXXX-XXXX-CCC0-PO287CS24CA4", // erforderlich. Hardware-Geräte-ID, die in der /registerDevice-API verwendet wird
    "tags": {                                       // erforderlich
      "Level": {                                    // Tag-Name
        "operation": "increment",                   // überschreibt das Integer-Tag in Dekrementen des folgenden Wertes 
        "value": -1                                 // Dekrement für den Tag-Wert
      }  
    }  
  }
}
```

### Listen-Tag-Werte anhängen

Um **das Listen-Tag mit neuen Werten zu erweitern**, verwenden Sie den `operation`-Parameter mit dem Wert "append" wie folgt:

```json title="Beispiel"
{
  "request": {
    "hwid": "3d124a79XXXXf189XXXX7dfd9XXXXafd", // erforderlich. Hardware-Geräte-ID, die in der /registerDevice-API verwendet wird
    "application": "6XXXX-XXXX3",               // erforderlich. Pushwoosh-Anwendungscode
    "tags": {                                   // erforderlich.
      "ListTag": {                              // Tag-Name
        "operation": "append",                  // hängt folgende Werte an die Werteliste des Tags an
        "value": [                              // anzuhängende Werte
          "tag2",
          "tag3"
        ]
      }
    }
  }
}
```

### Listen-Tag-Werte entfernen

Um einige Werte aus dem Listen-Tag zu entfernen, verwenden Sie die "remove"-Operation wie folgt:

```json
{
  "request":{
    "application": "12345-67890",                   // erforderlich. Pushwoosh-Anwendungscode
    "hwid": "21AB7628-XXXX-XXXX-CCC0-PO287CS24CA4", // erforderlich. Hardware-Geräte-ID, die in der /registerDevice-API verwendet wird
    "tags": {                                       // erforderlich.
      "In-App Product": {                           // Tag-Name
        "operation": "remove",                      // entfernt die folgenden Werte aus dem Listen-Tag
        "value": "outwear_02"                       // zu entfernender Wert oder Werte
      }
    }  
  }
}
```

### Tags nach UserID setzen

Um Tags für alle Geräte zu setzen, die einer bestimmten [User ID](/de/developer/api-reference/api-identifiers/#user-id) zugeordnet sind, verwenden Sie den "userId"-Parameter anstelle von "hwid".

<Aside type="caution">
Stellen Sie sicher, dass der Tag, für den Sie Werte setzen, [benutzerspezifisch](/de/developer/guides/audience-and-segmentation/tags/#tag-scope-general-vs-user-specific) ist.
</Aside>

```json title="Beispiel"
{
  "request":{
    "application": "AAAAA-BBBBB", // Pushwoosh-App-Code
    "userId": "some_user",        // User-ID, für die Sie Tags setzen möchten 
    "tags": {                     // zu setzende Tags und Werte
      "Language": "es"
    }  
  }
}
```

<Aside type="note">
Für E-Mails rufen Sie [`/setEmailTags`](/de/developer/api-reference/email-api/#setemailtags) auf.
</Aside>

**Status-Codes:**

| HTTP-Statuscode | status\_code | Beschreibung |
|---|---|---|
| 200 | 200 | Tags wurden erfolgreich gesetzt |
| 200 | 210 | Argumentfehler. Siehe `status_message` für weitere Informationen. |
| 400 | N/A | Fehlerhafte Anforderungszeichenfolge |
| 500 | 500 | Interner Fehler |


## getTags

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

Ruft eine Liste von Tags mit den entsprechenden Werten für das spezifische Gerät ab.

##### Anfrage-Header

| Name | Erforderlich | Wert | Beschreibung |
|---|---|---|---|
| Authorization | Ja | Token `XXXX` | [API-Device-Token](/de/developer/api-reference/api-access-token/#device-api-token) für den Zugriff auf die Device-API. Ersetzen Sie `XXXX` durch Ihr tatsächliches Device-API-Token. |

##### Anfrage-Body

| Name | Typ | Beschreibung |
| --- | --- | --- |
| application\* | string | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) |
| userId | string | [User ID](/de/developer/api-reference/api-identifiers/#user-id), die anstelle von "hwid" verwendet werden soll. Wenn zusammen mit einer "hwid" verwendet, hat die "hwid" Vorrang. |
| hwid | string | [Hardware-Geräte-ID](/de/developer/api-reference/api-identifiers/#hardware-id), die in der `/registerDevice`-Anfrage verwendet wird. |

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

```json title="Beispiel"
{
  "request":{
    "application": "XXXXX-XXXXX",   // erforderlich. Pushwoosh-Anwendungscode
    "hwid": "HWID",                 // optional. Hardware-Geräte-ID, die in der /registerDevice-API verwendet wird
    "userId": "USER_ID"             // optional. Kann anstelle von "hwid" verwendet werden, um Tags für einen bestimmten Benutzer abzurufen
  }
}
```

## setBadge

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

Sendet den aktuellen Badge-Wert für ein Gerät an Pushwoosh. Wird intern vom SDK aufgerufen.

##### Anfrage-Header

| Name | Erforderlich | Wert | Beschreibung |
|---|---|---|---|
| Authorization | Ja | Token `XXXX` | [API-Device-Token](/de/developer/api-reference/api-access-token/#device-api-token) für den Zugriff auf die Device-API. Ersetzen Sie `XXXX` durch Ihr tatsächliches Device-API-Token. |

##### Anfrage-Body

| Name | Typ | Beschreibung |
| --- | --- | --- |
| application\* | string | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) |
| hwid\* | string | [Hardware-Geräte-ID](/de/developer/api-reference/api-identifiers/#hardware-id), die in der `/registerDevice`-Anfrage verwendet wird. |
| badge\* | integer | Aktueller Badge der Anwendung. |

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

```json title="Beispiel"
{
  "request":{
    "application": "XXXXX-XXXXX",               // erforderlich. Pushwoosh-Anwendungscode
    "hwid": "8f65b16dXXXXe7a6XXXX9614XXXX0fb2", // erforderlich. Hardware-Geräte-ID, die in der /registerDevice-API verwendet wird
    "badge": 4                                  // erforderlich. Aktueller Badge der Anwendung
  }
}
```

Wird intern vom SDK aufgerufen. Sendet den aktuellen Badge-Wert für ein Gerät an Pushwoosh. Dies geschieht intern, wenn die App den Badge-Wert auf einem iOS-Gerät ändert. Ermöglicht das korrekte Funktionieren von automatisch inkrementierenden Badges.

<Aside type="caution">
Diese Methode wird **NICHT** verwendet, um den Badge-Wert auf dem Gerät zu aktualisieren. Verwenden Sie stattdessen bitte die [`/createMessage`](/de/developer/api-reference/messages-api/#createmessage)-Anfrage mit dem `"ios_badges"`-Parameter.
</Aside>



## applicationOpen

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

Registriert ein App-Öffnungsereignis. Wird intern vom SDK aufgerufen.

##### Anfrage-Header

| Name | Erforderlich | Wert | Beschreibung |
|---|---|---|---|
| Authorization | Ja | Token `XXXX` | [API-Device-Token](/de/developer/api-reference/api-access-token/#device-api-token) für den Zugriff auf die Device-API. Ersetzen Sie `XXXX` durch Ihr tatsächliches Device-API-Token. |

##### Anfrage-Body

| Name | Typ | Beschreibung |
| --- | --- | --- |
| application\* | string | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) |
| hwid\* | string | [Hardware-Geräte-ID](/de/developer/api-reference/api-identifiers/#hardware-id), die in der `/registerDevice`-Anfrage verwendet wird. |

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

```json title="Beispiel"
{
  "request": {
    "application": "XXXXX-XXXXX",              // erforderlich. Pushwoosh-Anwendungscode
    "hwid": "8f65b16dXXXXe7a6XXXX9614eXXXXfb2" // erforderlich. Hardware-Geräte-ID, die in der /registerDevice-API verwendet wird    
  }
}
```



## pushStat

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

Registriert ein Push-Öffnungsereignis. Wird intern vom SDK aufgerufen.

##### Anfrage-Header

| Name | Erforderlich | Wert | Beschreibung |
|---|---|---|---|
| Authorization | Ja | Token `XXXX` | [API-Device-Token](/de/developer/api-reference/api-access-token/#device-api-token) für den Zugriff auf die Device-API. Ersetzen Sie `XXXX` durch Ihr tatsächliches Device-API-Token. |
##### Anfrage-Body

| Name | Typ | Beschreibung |
| --- | --- | --- |
| application\* | string | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) |
| hwid\* | string | [Hardware-Geräte-ID](/de/developer/api-reference/api-identifiers/#hardware-id), die in der `/registerDevice`-Anfrage verwendet wird. |
| userId | string | [User ID](/de/developer/api-reference/api-identifiers/#user-id), die mit dem Push-Öffnungsereignis verknüpft werden soll. |
| hash | string | Hash-Tag, das in der Push-Benachrichtigung empfangen wurde ("p"-Parameter des Push-Payloads). |

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

```json title="Beispiel"
{
  "request": {
    "application": "XXXXX-XXXXX",               // erforderlich. Pushwoosh-Anwendungscode
    "hwid": "8f65b16dfXXXX7a6beXXXX14e1530fb2", // erforderlich. Hardware-Geräte-ID, die in der /registerDevice-API verwendet wird 
    "userId": "USER012345",                     // optional. Die User-ID, die mit dem Push-Öffnungsereignis verknüpft werden soll 
    "hash": "HASH_TAG"                          // optional. Hash-Tag, das in der Push-Benachrichtigung empfangen wurde
                                                //           ("p"-Parameter im Push-Payload)
  }
}
```


## messageDeliveryEvent

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

Registriert ein Push-Zustellungsereignis für das Gerät. Wird intern vom SDK aufgerufen.

##### Anfrage-Header

| Name | Erforderlich | Wert | Beschreibung |
|---|---|---|---|
| Authorization | Ja | Token `XXXX` | [API-Device-Token](/de/developer/api-reference/api-access-token/#device-api-token) für den Zugriff auf die Device-API. Ersetzen Sie `XXXX` durch Ihr tatsächliches Device-API-Token. |

##### Anfrage-Body

| Name | Typ | Beschreibung |
| --- | --- | --- |
| application\* | string | [Pushwoosh-Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) |
| hwid\* | string | [Hardware-Geräte-ID](/de/developer/api-reference/api-identifiers/#hardware-id), die in der `/registerDevice`-Anfrage verwendet wird. |
| hash | string | Hash-Tag, das in der Push-Benachrichtigung empfangen wurde ("p"-Parameter des Push-Payloads). |

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

```json title="Beispiel"
 {
  "request": {
    "application": "XXXXX-XXXXX",               // erforderlich. Pushwoosh-Anwendungscode
    "hwid": "8f65b16dfXXXX7a6bece9XXXX1530fb2", // erforderlich. Hardware-Geräte-ID, die in der /registerDevice-API verwendet wird
    "hash": "HASH_TAG"                          // optional. Hash-Tag, das in der Push-Benachrichtigung empfangen wurde
                                                //           ("p"-Parameter im Push-Payload)
  }
}
```