Freigeben über


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 (veraltet) 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.