Anforderungs- und Antwortheader des Pushbenachrichtigungsdiensts (Windows-Runtime-Apps)

In diesem Thema werden die zwischen Web-APIs und Protokolle benötigten Dienste beschrieben, um Pushbenachrichtigungen zu senden.

In der Übersicht über die Windows-Pushbenachrichtigungsdienste (Windows Push Notification Services, WNS) werden die Konzepte, die Anforderungen und die Funktionsweise von Pushbenachrichtigungen und WNS erörtert.

Anfordern und Empfangen eines Zugriffstokens

In diesem Abschnitt werden die Anforderungs- und Antwortparameter im Zusammenhang mit der Authentifizierung bei WNS beschrieben.

Access token request (Zugriffstokenanforderung)

Eine HTTP-Anforderung wird an WNS gesendet, um den Clouddienst zu authentifizieren und im Gegenzug ein Zugriffstoken abzurufen. Die Anforderung wird über SSL (Secure Sockets Layer) an https://login.live.com/accesstoken.srf ausgegeben.

Zugriffstoken-Anforderungsparameter

Der Clouddienst übermittelt diese erforderlichen Parameter im HTTP-Anforderungstext unter Verwendung des Formats „application/x-www-form-urlencoded“. Sie müssen sicherstellen, dass alle Parameter URL-codiert sind.

Parameter	Erforderlich	BESCHREIBUNG
grant_type	TRUE	Muss auf client_credentials festgelegt sein.
client_id	TRUE	Sicherheits-ID (SID) des Pakets für Ihren Clouddienst, die bei der Registrierung Ihrer App im Microsoft Store zugewiesen wurde.
client_secret	TRUE	Geheimer Schlüssel für Ihren Clouddienst, der bei der Registrierung Ihrer App im Microsoft Store zugewiesen wurde.
scope	TRUE	Muss auf notify.windows.com festgelegt werden.

Zugriffstokenantwort

WNS authentifiziert den Clouddienst und antwortet bei Erfolg mit „200 – OK“, einschließlich des Zugriffstokens. Andernfalls antwortet WNS mit einem passenden HTTP-Fehlercode, wie im OAuth 2.0-Protokollentwurf beschrieben.

Zugriffstoken-Antwortparameter

Ein Zugriffstoken wird in der HTTP-Antwort zurückgegeben, wenn der Clouddienst erfolgreich authentifiziert wurde. Dieses Zugriffstoken kann in Benachrichtigungsanforderungen verwendet werden, bis es abläuft. Die HTTP-Antwort verwendet den Medientyp „application/json“.

Parameter	Erforderlich	Beschreibung
access_token	TRUE	Das Zugriffstoken, das der Clouddienst zum Senden einer Benachrichtigung verwendet.
token_type	FALSE	Wird immer als bearer zurückgegeben.

Antwortcode

HTTP-Antwortcode	Beschreibung
200 – OK	Die Anforderung wurde erfolgreich gesendet.
400 – ungültige Anforderung	Die Authentifizierung war nicht erfolgreich. Antwortparameter finden Sie im RFC (Request for Comments) des OAuth-Entwurfs.

Beispiel

Es folgt ein Beispiel für eine erfolgreiche Authentifizierungsantwort:

 HTTP/1.1 200 OK   
 Cache-Control: no-store
 Content-Length: 422
 Content-Type: application/json
 
 {
     "access_token":"EgAcAQMAAAAALYAAY/c+Huwi3Fv4Ck10UrKNmtxRO6Njk2MgA=", 
     "token_type":"bearer",
     "expires_in": 86400
 }

Senden einer Benachrichtigungsanforderung und Empfangen einer Antwort

In diesem Abschnitt werden die Header beschrieben, die bei einer HTTP-Anforderung an WNS zur Übermittlung einer Benachrichtigung verwendet werden, sowie die in der Antwort vorkommenden Header.

• Senden einer Benachrichtigungsanforderung
• Senden einer Benachrichtigungsantwort
• Nicht unterstützte HTTP-Features

Senden einer Benachrichtigungsanforderung

Beim Senden einer Benachrichtigungsanforderung übermittelt die aufrufende App eine HTTP-Anforderung per SSL, die an den Uniform Resource Identifier (URI) des Kanals gerichtet ist. „Content-Length“ ist ein HTTP-Standardheader, der in der Anforderung angegeben werden muss. Alle weiteren Standardheader sind entweder optional oder werden nicht unterstützt.

Außerdem können in der Benachrichtigungsanforderung die hier aufgeführten benutzerdefinierten Anforderungsheader verwendet werden. Einige Header sind erforderlich, während andere optional sind.

Anforderungsparameter

Headername	Erforderlich	Beschreibung
Autorisierung	TRUE	Standardmäßiger HTTP-Autorisierungsheader, der zum Authentifizieren Ihrer Benachrichtigungsanforderung verwendet wird. Ihr Clouddienst stellt sein Zugriffstoken in diesem Header bereit.
Inhaltsart	TRUE	Standardmäßiger HTTP-Autorisierungsheader. Für Popup-, Kachel- und Badgebenachrichtigungen muss dieser Header auf text/xml festgelegt werden. Für unformatierte Benachrichtigungen muss dieser Header auf application/octet-stream festgelegt werden.
Inhaltslänge	TRUE	Standardmäßiger HTTP-Autorisierungsheader, um die Größe der Anforderungsnutzdaten anzugeben.
X-WNS-Type	TRUE	Definiert den Benachrichtigungstyp in den Nutzdaten: Kachel, Popup, Badge oder unformatiert.
X-WNS-Cache-Policy	FALSE	Aktiviert oder deaktiviert die Zwischenspeicherung von Benachrichtigungen. Dieser Header gilt nur für Kachel-, Badge- und unformatierte Benachrichtigungen.
X-WNS-RequestForStatus	FALSE	Fordert den Gerätestatus und den WNS-Verbindungsstatus in der Benachrichtigungsantwort an.
X-WNS-Tag	FALSE	Eine Zeichenfolge, über die eine Benachrichtigung mit einer identifizierenden Bezeichnung versehen werden kann. Wird für Kacheln verwendet, die die Benachrichtigungswarteschlange unterstützen. Dieser Header gilt nur für Kachelbenachrichtigungen.
X-WNS-TTL	FALSE	Ganzzahliger Wert, ausgedrückt in Sekunden, der die Gültigkeitsdauer (Time to Live, TTL) angibt.
MS-CV	FALSE	Korrelationsvektor, der für Ihre Anforderung verwendet wird.

Wichtige Hinweise

• „Content-Length“ und „Content-Type“ werden als einzige HTTP-Standardheader in die an den Client übermittelte Benachrichtigung aufgenommen. Dies gilt unabhängig davon, ob andere Standardheader in der Anforderung enthalten waren.
• Alle weiteren HTTP-Standardheader werden entweder ignoriert oder geben einen Fehler zurück, wenn die Funktionalität nicht unterstützt wird.
• Ab Februar 2023 speichert WNS nur noch eine Kachelbenachrichtigung zwischen, wenn das Gerät offline ist.

Autorisierung

Der Autorisierungsheader wird verwendet, um die Anmeldeinformationen des Aufrufers gemäß OAuth 2.0-Autorisierungsmethode für Bearertoken anzugeben.

Die Syntax umfasst ein Zeichenfolgenliteral „Bearer“, gefolgt von einem Leerzeichen, gefolgt von Ihrem Zugriffstoken. Dieses Zugriffstoken wird abgerufen, indem die oben beschriebene Zugriffstokenanforderung ausgegeben wird. Dasselbe Zugriffstoken kann so lange für nachfolgende Benachrichtigungsanforderungen verwendet werden, bis es abläuft.

Dieser Header ist erforderlich.

Authorization: Bearer <access-token>

X-WNS-Type

Dies sind die von WNS unterstützten Benachrichtigungstypen. Dieser Header gibt den Typ der Benachrichtigung an und wie WNS sie verarbeiten soll. Nachdem die Benachrichtigung den Client erreicht hat, werden die tatsächlichen Nutzdaten mit diesem angegebenen Typ abgeglichen. Dieser Header ist erforderlich.

X-WNS-Type: wns/toast | wns/badge | wns/tile | wns/raw

Wert	Beschreibung
wns/badge	Eine Benachrichtigung zur Erstellung einer Badgeüberlagerung auf der Kachel. Der in der Anforderung enthaltene Content-Type-Header muss auf text/xml festgelegt sein.
wns/tile	Eine Benachrichtigung zur Aktualisierung des Kachelinhalts. Der in der Anforderung enthaltene Content-Type-Header muss auf text/xml festgelegt sein.
wns/toast	Eine Benachrichtigung zum Auslösen einer Popupbenachrichtigung auf dem Client. Der in der Anforderung enthaltene Content-Type-Header muss auf text/xml festgelegt sein.
wns/raw	Eine Benachrichtigung, die benutzerdefinierte Nutzdaten enthalten kann und direkt an die App übermittelt wird. Der in der Anforderung enthaltene Content-Type-Header muss auf application/octet-stream festgelegt sein.

X-WNS-Cache-Policy

Wenn das Zielgerät für die Benachrichtigung offline ist, speichert WNS für jeden Kanal-URI eine Badge-, eine Kachel- und eine Popupbenachrichtigung zwischen. Standardmäßig werden unformatierte Benachrichtigungen nicht zwischengespeichert, aber wenn das Zwischenspeichern von unformatierten Benachrichtigungen aktiviert ist, wird eine unformatierte Benachrichtigung zwischengespeichert. Elemente werden nicht unbegrenzt im Cache zwischengespeichert und nach einem angemessenen Zeitraum gelöscht. Andernfalls wird der zwischengespeicherte Inhalt übermittelt, wenn das Gerät das nächste Mal online geht.

X-WNS-Cache-Policy: cache | no-cache

Wert	Beschreibung
cache	Standard. Benachrichtigungen werden zwischengespeichert, wenn die Benutzer*innen offline sind. Dies ist die Standardeinstellung für Kachel- und Badgebenachrichtigungen.
no-cache	Die Benachrichtigung wird nicht zwischengespeichert, wenn die Benutzer*innen offline sind. Dies ist die Standardeinstellung für unformatierte Benachrichtigungen.

X-WNS-RequestForStatus

Gibt an, ob die Antwort den Gerätestatus und den WNS-Verbindungsstatus enthalten soll. Dieser Header ist optional.

    X-WNS-RequestForStatus: true | false

Wert	Beschreibung
true	Gibt den Geräte- und den Benachrichtigungsstatus in der Antwort zurück.
false	Standard. Gerätestatus und Benachrichtigungsstatus werden nicht zurückgeben.

X-WNS-Tag

Weist einer Benachrichtigung eine Tagbezeichnung zu. Das Tag wird in der Ersetzungsrichtlinie für die Kachel in der Benachrichtigungswarteschlange verwendet, wenn für eine App das Durchlaufen von Benachrichtigungen aktiviert wurde. Wenn in der Warteschlange bereits eine Benachrichtigung mit diesem Tag vorhanden ist, nimmt eine neue Benachrichtigung mit dem gleichen Tag ihren Platz ein.

Hinweis

Dieser Header ist optional und wird nur beim Senden von Kachelbenachrichtigungen verwendet.

    X-WNS-Tag: <string value>

Wert	Beschreibung
Zeichenfolgenwert	Eine alphanumerische Zeichenfolge mit maximal 16 Zeichen.

X-WNS-TTL

Gibt die Ablaufzeit (TTL) für eine Benachrichtigung an. Diese wird normalerweise nicht benötigt, kann aber verwendet werden, wenn Sie sicherstellen möchten, dass Ihre Benachrichtigungen nicht später als zu einem bestimmten Zeitpunkt angezeigt werden. Der TTL-Wert wird in Sekunden angegeben und ist relativ zu dem Zeitpunkt, an dem WNS die Anforderung empfängt. Wenn eine Gültigkeitsdauer (TTL) angegeben ist, zeigt das Gerät die Benachrichtigung nach Ablauf dieses Zeitraums nicht mehr an. Hinweis: Eine zu kurze Gültigkeitsdauer kann dazu führen, dass die Benachrichtigung überhaupt nicht angezeigt wird. Im Allgemeinen beträgt das Messintervall von Ablaufzeiten mindestens eine Minute.

Dieser Header ist optional. Wenn kein Wert angegeben wird, läuft die Benachrichtigung nicht ab und wird nach dem normalen Ersetzungsschema für Benachrichtigungen ersetzt.

X-WNS-TTL: <integer value>

Wert	Beschreibung
Ganzzahliger Wert	Die Lebensdauer der Benachrichtigung in Sekunden, nachdem WNS die Anforderung empfangen hat.

X-WNS-SuppressPopup

Hinweis

Bei Windows Phone Store-Apps haben Sie die Möglichkeit, die Benutzeroberfläche einer Popupbenachrichtigung zu unterdrücken und die Benachrichtigung stattdessen direkt an das Info-Center zu senden. Dadurch wird Ihre Benachrichtigung lautlos zugestellt, was für weniger dringende Benachrichtigungen möglicherweise die bessere Option ist. Dieser Header ist optional und wird nur für Windows Phone-Kanäle verwendet. Wenn Sie diesen Header in einen Windows-Kanal einfügen, wird Ihre Benachrichtigung verworfen, und Sie erhalten eine Fehlerantwort von WNS.

X-WNS-SuppressPopup: true | false

Wert	Beschreibung
true	Die Popupbenachrichtigung wird direkt an das Info-Center gesendet; die Benutzeroberfläche für die Popupbenachrichtigung wird nicht angezeigt.
false	Standard. Löst die Benutzeroberfläche der Popupbenachrichtigung aus und fügt die Benachrichtigung im Info-Center ein.

X-WNS-Group

Hinweis

Das Info-Center für Windows Phone Store-Apps kann nur dann mehrere Popupbenachrichtigungen mit dem gleichen Tag anzeigen, wenn diese durch Bezeichner unterschiedlichen Gruppen zugeordnet sind. Nehmen Sie zum Beispiel eine Rezeptbuch-App. Jedes Rezept wird durch ein Tag identifiziert. Eine Popupbenachrichtigung, die einen Kommentar zu diesem Rezept enthält, weist das Tag für das Rezept auf, wäre aber mit einer Gruppenbezeichnung für Kommentare gekennzeichnet. Eine Popupbenachrichtigung, die eine Bewertung für dieses Rezept enthält, würde ebenfalls das Tag für dieses Rezept aufweisen, wäre aber mit einer Gruppenbezeichnung für Bewertungen versehen. Diese unterschiedlichen Gruppenbezeichnungen würden es ermöglichen, dass beide Popupbenachrichtigungen gleichzeitig im Info-Center angezeigt werden. Dieser Header ist optional.

X-WNS-Group: <string value>

Wert	Beschreibung
Zeichenfolgenwert	Eine alphanumerische Zeichenfolge mit maximal 16 Zeichen.

X-WNS-Match

Hinweis

Wird zusammen mit der HTTP DELETE-Methode verwendet, um eine bestimmte Popupbenachrichtigung, eine festgelegte Anzahl von Popupbenachrichtigungen (entweder nach Tag oder Gruppe) oder alle Popupbenachrichtigungen aus dem Info-Center für Windows Phone Store-Apps zu entfernen. Dieser Header kann eine Gruppe, ein Tag oder beides angeben. Dieser Header ist in einer HTTP DELETE-Benachrichtigungsanforderung erforderlich. Alle in dieser Benachrichtigungsanforderung enthaltenen Nutzdaten werden ignoriert.

X-WNS-Match: type:wns/toast;group=<string value>;tag=<string value> | type:wns/toast;group=<string value> | type:wns/toast;tag=<string value> | type:wns/toast;all

Wert	Beschreibung
type:wns/toast;group=<string value>;tag=<string value>	Entfernt eine einzelne Benachrichtigung, die sowohl mit dem angegebenen Tag als auch mit der Gruppe gekennzeichnet ist.
type:wns/toast;group=<string value>	Entfernt alle Benachrichtigungen, die mit der angegebenen Gruppe gekennzeichnet sind.
type:wns/toast;tag=<string value>	Entfernt alle Benachrichtigungen, die mit dem angegebenen Tag gekennzeichnet sind.
type:wns/toast;all	Löscht alle Benachrichtigungen Ihrer App aus dem Info-Center.

Senden einer Benachrichtigungsantwort

Nachdem WNS die Benachrichtigungsanforderung verarbeitet hat, wird eine HTTP-Nachricht als Antwort gesendet. In diesem Abschnitt werden die Parameter und Header erläutert, die in dieser Antwort zu finden sind.

Antwortparameter

Headername	Erforderlich	Beschreibung
X-WNS-Debug-Trace	FALSE	Informationen zum Debuggen, die protokolliert werden sollten, um die Behebung gemeldeter Probleme zu erleichtern.
X-WNS-DeviceConnectionStatus	FALSE	Der Gerätestatus. Dieser wird nur zurückgegeben, wenn er in der Benachrichtigungsanforderung über den X-WNS-RequestForStatus-Header angefordert wurde.
X-WNS-Error-Description	FALSE	Eine für Menschen lesbare Zeichenfolge, die protokolliert werden sollte, um das Debuggen zu erleichtern.
X-WNS-Msg-ID	FALSE	Ein eindeutiger Bezeichner für die Benachrichtigung, der zu Debugzwecken verwendet wird. Wenn ein Problem gemeldet wird, sollten diese Informationen protokolliert werden, um die Problembehandlung zu erleichtern.
X-WNS-Status	FALSE	Gibt an, ob WNS die Benachrichtigung erfolgreich empfangen und verarbeitet hat. Wenn ein Problem gemeldet wird, sollten diese Informationen protokolliert werden, um die Problembehandlung zu erleichtern.
MS-CV	FALSE	Informationen zum Debuggen, die protokolliert werden sollten, um die Behebung gemeldeter Probleme zu erleichtern.

X-WNS-Debug-Trace

Dieser Header gibt nützliche Debuginformationen als Zeichenfolge zurück. Es wird empfohlen, diesen Header zu protokollieren, um Entwicklern beim Debuggen von Problemen zu helfen. Dieser Header wird zusammen mit dem X-WNS-Msg-ID-Header und MS-CV benötigt, wenn Sie ein Problem an WNS melden.

X-WNS-Debug-Trace: <string value>

Wert	Beschreibung
Zeichenfolgenwert	Eine alphanumerische Zeichenfolge.

X-WNS-DeviceConnectionStatus

Dieser Header gibt den Gerätestatus an die aufrufende Anwendung zurück, wenn dies im X-WNS-RequestForStatus-Header der Benachrichtigungsanforderung angefordert wird.

X-WNS-DeviceConnectionStatus: connected | disconnected | tempdisconnected

Wert	Beschreibung
connected	Das Gerät ist online und mit WNS verbunden.
getrennt	Das Gerät ist offline und nicht mit WNS verbunden.
tempconnected	Das Gerät hat vorübergehend die Verbindung zum WNS verloren, z. B. wenn eine 3G-Verbindung abbricht oder der WLAN-Schalter an einem Laptop umgelegt wird. Dies wird von der Benachrichtigungsclientplattform als vorübergehende Unterbrechung und nicht als beabsichtigte Trennung der Verbindung eingestuft.

X-WNS-Error-Description

Dieser Header stellt eine für Menschen lesbare Zeichenfolge bereit, die zum leichteren Debuggen protokolliert werden sollte.

X-WNS-Error-Description: <string value>

Wert	Beschreibung
Zeichenfolgenwert	Eine alphanumerische Zeichenfolge.

X-WNS-Msg-ID

Mit diesem Header wird dem Aufrufer ein Bezeichner für die Benachrichtigung mitgeteilt. Es wird empfohlen, diesen Header zu protokollieren, um das Debuggen von Fehlern zu erleichtern. Dieser Header wird zusammen mit X-WNS-Debug-Trace und MS-CV benötigt, wenn Sie ein Problem an WNS melden.

X-WNS-Msg-ID: <string value>

Wert	Beschreibung
Zeichenfolgenwert	Eine alphanumerische Zeichenfolge mit maximal 16 Zeichen.

X-WNS-Status

Dieser Header beschreibt, wie WNS die Benachrichtigungsanforderung verarbeitet hat. Diese Information kann verwendet werden, anstatt Antwortcodes als Erfolg oder Fehler zu interpretieren.

X-WNS-Status: received | dropped | channelthrottled

Wert	Beschreibung
empfangen	Die Benachrichtigung wurde empfangen und von WNS verarbeitet. Hinweis: Dies garantiert nicht, dass das Gerät die Benachrichtigung empfangen hat.
dropped	Die Benachrichtigung wurde ausdrücklich verworfen, weil ein Fehler aufgetreten ist, oder weil der Client diese Benachrichtigungen ausdrücklich abgelehnt hat. Popupbenachrichtigungen werden auch verworfen, wenn das Gerät offline ist.
channelthrottled	Die Benachrichtigung wurde verworfen, weil der App-Server die Ratenbegrenzung für diesen speziellen Kanal überschritten hat.

MS-CV

Dieser Header enthält einen auf die Anforderung bezogenen Korrelationsvektor, der in erster Linie zum Debuggen verwendet wird. Wenn in der Anforderung ein CV-Wert angegeben wird, verwendet WNS diesen Wert, andernfalls generiert WNS einen CV-Wert und sendet diesen in der Antwort. Dieser Header wird zusammen mit X-WNS-Debug-Trace und dem X-WNS-Msg-ID-Header benötigt, wenn Sie ein Problem an WNS melden.

Wichtig

Erstellen Sie für jede Anforderung einer Pushbenachrichtigung einen neuen CV-Wert, wenn Sie einen eigenen CV-Wert bereitstellen.

MS-CV: <string value>

Wert	Beschreibung
Zeichenfolgenwert	Folgt dem Standard für Korrelationsvektoren.

Antwortcodes

Jede HTTP-Nachricht enthält einen dieser Antwortcodes. WNS empfiehlt Entwickler*innen, den Antwortcode zu protokollieren, um ihn beim Debuggen zu verwenden. Wenn Entwickler*innen ein Problem an WNS melden, müssen sie Antwortcodes und Headerinformationen angeben.

HTTP-Antwortcode	Beschreibung	Empfohlene Maßnahme
200 OK	Die Benachrichtigung wurde von WNS akzeptiert.	Keine erforderlich.
400 – ungültige Anforderung	Mindestens ein Header wurde falsch angegeben oder steht im Konflikt mit einem anderen Header.	Protokollieren Sie die Details zu Ihrer Anforderung. Überprüfen Sie Ihre Anforderung, und vergleichen Sie sie mit dieser Dokumentation.
401 – Nicht autorisiert	Der Clouddienst hat kein gültiges Authentifizierungsticket vorgelegt. Das OAuth-Ticket ist möglicherweise ungültig.	Fordern Sie ein gültiges Zugriffstoken an, indem Sie Ihren Clouddienst mithilfe der Zugriffstokenanforderung authentifizieren.
403 Verboten	Der Clouddienst ist nicht zum Senden einer Benachrichtigung an diesen URI autorisiert, obwohl er authentifiziert wurde.	Das in der Anforderung angegebene Zugriffstoken stimmt nicht mit den Anmeldeinformationen der App überein, die den Kanal-URI angefordert hat. Stellen Sie sicher, dass der Paketname im Manifest Ihrer App mit den Anmeldeinformationen für den Clouddienst übereinstimmt, die Sie Ihrer App im Dashboard zugewiesen haben.
404 Seite nicht gefunden	Der Kanal-URI ist ungültig oder wird von WNS nicht erkannt.	Protokollieren Sie die Details zu Ihrer Anforderung. Senden Sie keine weiteren Benachrichtigungen an diesen Kanal. Benachrichtigungen an diese Adresse führen zu einem Fehler.
405 Methode nicht erlaubt	Ungültige Methode (GET, CREATE). Zulässig ist nur POST (Windows oder Windows Phone) oder DELETE (nur Windows Phone).	Protokollieren Sie die Details zu Ihrer Anforderung. Stellen Sie auf die Verwendung von HTTP POST um.
406 – Nicht annehmbar	Der Clouddienst hat den Grenzwert für die Drosselung überschritten.	Senden Sie Ihre Anforderung nach dem Retry-After-Headerwert in der Antwort.
410 Nicht mehr vorhanden	Der Kanal ist abgelaufen.	Protokollieren Sie die Details zu Ihrer Anforderung. Senden Sie keine weiteren Benachrichtigungen an diesen Kanal. Fordern Sie über Ihre App einen neuen Kanal-URI an.
410 – Domäne blockiert	Die sendenden Domäne wurde von WNS blockiert.	Senden Sie keine weiteren Benachrichtigungen an diesen Kanal. Die sendende Domäne wurde von WNS wegen missbräuchlicher Pushbenachrichtigungen blockiert.
413 – Anforderungsentität zu groß	Die Größe der Nutzdaten in der Benachrichtigung überschreiten den Grenzwert von 5.000 Byte.	Protokollieren Sie die Details zu Ihrer Anforderung. Überprüfen Sie die Nutzdaten, um sicherzustellen, dass sie den Größenbeschränkungen entsprechen.
500: Interner Serverfehler	Die Benachrichtigung konnte aufgrund eines internen Fehlers nicht übermittelt werden.	Protokollieren Sie die Details zu Ihrer Anforderung. Melden Sie dieses Problem über die Entwicklerforen.
503 – Dienst ist nicht verfügbar	Der Server ist zurzeit nicht verfügbar.	Protokollieren Sie die Details zu Ihrer Anforderung. Melden Sie dieses Problem über die Entwicklerforen. Wenn der Retry-After-Header berücksichtigt wird, senden Sie Ihre Anforderung nach dem Retry-After-Headerwert in der Antwort.

Nicht unterstützte HTTP-Features

Die WNS-Webschnittstelle unterstützt HTTP 1.1, aber nicht die folgenden Features:

• Segmentierung
• Pipelining (POST ist nicht idempotent)
• Wenngleich unterstützt, sollten Entwickler*innen „Expect-100“ deaktivieren, da dies zu einer Wartezeit beim Senden einer Benachrichtigung führt.