Senden einer nativen WNS-Benachrichtigung (Windows Push Notification Service)

Artikel
05/26/2023

Sendet eine native WNS-Benachrichtigung über einen Notification Hub.

Anforderung

Methode	Anforderungs-URI	HTTP-Version
POST	`https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01`	HTTP/1.1

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader	BESCHREIBUNG
Authorization	SAS-Token generiert, wie in Shared Access Signature Authentication with Service Bus angegeben.
Content-Type	Wird auf `application/json;charset=utf-8` oder `application/xml` festgelegt. Wenn der Benachrichtigungstyp (`X-WNS-Type`) ist `wns/raw`, legen Sie auf `application/octet-stream`fest.
ServiceBusNotification-Tags	`{single tag identifier}` (optional)
ServiceBusNotification-Format	Legen Sie den Wert `windows`
X-WNS-	Alle Header, die mit X-WNS beginnen, werden an WNS weitergeleitet.

Anforderungstext

Der Anforderungstext ist ein VON WNS angegebenes XML-Dokument. Wenn die Benachrichtigung vom Typ "wns/raw" ist, besteht der Text aus einem beliebigen Text bis zu 5 KB. Beispiel:

<?xml version="1.0" encoding="utf-8" ?>
<toast>
    <visual lang="en-US">
        <binding template="ToastText01">
            <text id="1">
                This is my toast message for Win8!
            </text>
        </binding>
    </visual>
</toast>

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Antwortcodes

Code	BESCHREIBUNG
200	Nachricht erfolgreich gesendet.
400	Die Anforderung ist falsch formatiert (z. B. ungültige Routingheader, ungültiger Inhaltstyp, Nachricht überschreitet die Größe, ungültiges Nachrichtenformat).
401	Autorisierungsfehler Der Zugriffsschlüssel war falsch.
403	Kontingent überschritten oder Nachricht zu groß; -Nachricht wurde abgelehnt.
404	Kein Nachrichtenbranch am URI.
413	Die angeforderte Entität ist zu groß. Die Nachrichtengröße darf nicht mehr als 64 KB betragen.

Informationen zu status Codes finden Sie unter Status- und Fehlercodes.

Antwortheader

Antwortheader	BESCHREIBUNG
Standort	Dieser Header ist nur für Notification Hubs im Standard-Tarif verfügbar. Dieser Header enthält die Benachrichtigungs-ID. Es wird mit Telemetriedaten pro Nachricht und korrelieren PNS-Feedback verwendet. Der Speicherortheader verwendet das folgende Format: `https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04`

Antworttext

Keine.

Freigeben über