---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Push-Installations-API

# Push-Installations-API {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die Push-Installation Die API stellt Endpunkte zum Registrieren und Aufheben der Registrierung der Token bereit, mit denen Mobilgeräte Push-Benachrichtigungen von einer Anwendung erhalten können.
Eine Push-Benachrichtigung ist eine Textnachricht, die auf dem Mobilgerät eines Anwenders angezeigt wird, um ihn über etwas Wichtiges zu warnen oder ihn aufzufordern, eine Aktion auszuführen.

Beim Erstellen anwenderdefinierter mobiler Anwendungen müssen Sie das Gerät beim Service des Herstellers registrieren, um Push-Benachrichtigungen einzurichten. Der Service muss die Adresse des Geräts eines Anwenders kennen, damit er ordnungsgemäß Benachrichtigungen mithilfe von Push-Token an dieses Gerät senden kann. Das Gerät muss auch in der Lage sein, die Benachrichtigungen zu empfangen und darauf zu reagieren. Anweisungen zum Registrieren eines Geräts und zum Abrufen eines Push-Tokens finden Sie in der Dokumentation des Betriebssystementwicklers des Geräts. Beispiel: Informationen zu Apple-Geräten finden Sie unter <https://developer.apple.com/documentation/usernotifications/registering_your_app_with_apns>.

## Push-Installation: /Now/Push/{pushApplicationName}/Installation VERÖFFENTLICHEN {#ariaid-title2}

Fügt Token hinzu oder aktualisiert sie, mit denen Geräte Push-Benachrichtigungen von der angegebenen Anwendung erhalten können.

### URL-Format {#push-POST-installation__section_x12_fqg_dmb}

Versionierte URL: /api/now/{api_Version}/Push/{pushApplicationName}/Installation

Standard-URL: /api/now/Push/{pushApplicationName}/Installation  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#push-POST-installation__entry__2}{#push-POST-installation__version-not_optional-RESTAPI}

| Parameter | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| PushApplicationName | Name der Anwendung, für die die Push-Benachrichtigungen registriert werden sollen. Dieser Parameter muss mit dem Wert in der Namensspalte für die zugehörige Anwendung übereinstimmen. Datentyp: Zeichenfolge Tabelle: Push-Anwendung \[sys_Push_Application\] |
[Tabelle : 1. Pfad-Parameter]

{#push-POST-installation__entry__8}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Abfrageparameter]

{#push-POST-installation__entry__12}

| Element | Beschreibung |
|-|-|
| platform | Plattform, auf der die Push-Benachrichtigung registriert werden soll. Datentyp: Zeichenfolge Tabelle: Im Feld Name der Tabelle „Push-Plattform" \[sys_Push_Platform\]. |
| Token | Token, das vom Gerätehersteller bereitgestellt wird, z. B. Apple, wenn sich die mobile Anwendung für den Empfang von Push-Benachrichtigungen registriert. Datentyp: Zeichenfolge Gespeichert in: Installation von Push-Benachrichtigungen \[sys_push_notif_app_install\] |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#push-POST-installation__entry__18}{#push-POST-installation__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 4. Anforderungskopfzeilen.]

{#push-POST-installation__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#push-POST-installation__entry__26}{#push-POST-installation__entry-200-status-code}{#push-POST-installation__entry-401-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim serverseitigen Code ist ein Logikfehler aufgetreten. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#push-POST-installation__entry__36}

| Name | Beschreibung |
|-|-|
| Keine |   |
[ ]

### Beispiel für Curl-Anforderung

    curl -X POST \
      https://instance.servicenow.com/api/now/push/ServiceNowPushApp/installation \
    --header "Content-Type: application/json" \
    --user "username":"password" \
    --data '{"platform":"Apple","token":"544836d77ac2e551bbf78204630509a7d494fc87f52e85da52e5b5d42910e2cf"}' \

    None

## Push-Installation -- /now/Push/{pushApplicationName}/removeInstallation VERÖFFENTLICHEN {#ariaid-title3}

Deaktiviert die Token, mit denen Mobilgeräte Push-Benachrichtigungen von der angegebenen Anwendung empfangen können.

### URL-Format {#push-POST-removeInstallation__section_uy3_drg_dmb}

Versionierte URL: /api/now/{api_Version}/Push/{pushApplicationName}/removeInstallation

Standard-URL: /api/now/Push/{pushApplicationName}/removeInstallation  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#push-POST-removeInstallation__entry__2}{#push-POST-removeInstallation__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| PushApplicationName | Name der Anwendung, für die die Registrierung der Push-Benachrichtigungen aufgehoben werden soll. Datentyp: Zeichenfolge Tabelle: Im Feld Name für die zugehörige Anwendung in der Tabelle „Push-Anwendung" \[sys_Push_Application\]. |
[Tabelle : 7. Pfad-Parameter]

{#push-POST-removeInstallation__entry__8}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Abfrageparameter]

{#push-POST-removeInstallation__entry__12}

| Element | Beschreibung |
|-|-|
| platform | Plattform, auf der die Push-Benachrichtigung registriert werden soll. Datentyp: Zeichenfolge Tabelle: Im Feld Name der Tabelle „Push-Plattform" \[sys_Push_Platform\]. |
[Tabelle : 9. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#push-POST-removeInstallation__entry__16}{#push-POST-removeInstallation__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 10. Anforderungskopfzeilen.]

{#push-POST-removeInstallation__entry__20}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#push-POST-removeInstallation__entry__24}{#push-POST-removeInstallation__entry-200-status-code}{#push-POST-removeInstallation__entry-401-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim serverseitigen Code ist ein Logikfehler aufgetreten. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#push-POST-removeInstallation__entry__34}

| Name | Beschreibung |
|-|-|
| Keine |   |
[ ]

### Beispiel für Curl-Anforderung

    curl -X POST \
      https://instance.servicenow.com/api/now/push/ServiceNowPushApp/removeInstallation \
    --header "Content-Type: application/json" \
    --user "username":"password" \
    --data '{"platform":"Apple"}' \

    None


