Push-Installations-API

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 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 Pushbenachrichtigung ist eine Textnachricht, die auf dem mobilen Gerät eines Benutzers angezeigt wird, um ihn auf etwas Wichtiges hinzuweisen oder ihn zu einer Aktion aufzufordern.

    Wenn Sie anwenderdefinierte mobile Anwendungen erstellen, 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 Benachrichtigungen ordnungsgemäß mithilfe von Push-Token an dieses Gerät senden kann. Das Gerät muss auch in der Lage sein, die Benachrichtigungen zu empfangen und zu bearbeiten. 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: NACH /now/Push/{pushApplicationName}/Installation

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

    URL-Format

    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 . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 1. Pfad-Parameter
    Parameter Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    PusApplicationName Name der Anwendung, für die die Push-Benachrichtigungen registriert werden sollen. Dieser Parameter muss mit dem Wert in der Spalte Name für die zugehörige Anwendung übereinstimmen.

    Datentyp: Zeichenfolge

    Tabelle: Push-Anwendung [sys_Push_Application]
    Tabelle : 2. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 3. Anforderungstextparameter (XML oder JSON)
    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: Push-Benachrichtigungsinstallation [sys_Push_notif_App_install]

    Header

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter Unterstützte REST-API-Header .

    Tabelle : 4. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Content-Type Datenformat des Anforderungstexts. Unterstützt nur application/json.
    Tabelle : 5. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    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 .

    Tabelle : 6. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    401 Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben.
    500 Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten.

    Antworttext-Parameter (JSON oder XML)

    Name Beschreibung
    Keine

    Beispiel für eine 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 – NACH /now/Push/{pushApplicationName}/removeInstallation

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

    URL-Format

    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 . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf der Formular „geskripteter REST-Service“ .

    Unterstützte Anforderungsparameter

    Tabelle : 7. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    PusApplicationName Name der Anwendung, für die die Registrierung der Push-Benachrichtigungen aufgehoben werden soll.

    Datentyp: Zeichenfolge

    Tabelle: Im Feld Name der zugehörigen Anwendung in der Tabelle „Push-Anwendung“ [sys_Push_Application].
    Tabelle : 8. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 9. Anforderungstextparameter (XML oder JSON)
    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].

    Header

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter Unterstützte REST-API-Header .

    Tabelle : 10. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Content-Type Datenformat des Anforderungstexts. Unterstützt nur application/json.
    Tabelle : 11. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    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 .

    Tabelle : 12. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    401 Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben.
    500 Interner Serverfehler. Im serverseitigen Code ein logischer Fehler aufgetreten.

    Antworttext-Parameter (JSON oder XML)

    Name Beschreibung
    Keine

    Beispiel für eine 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