Senden einer nativen WNS-Benachrichtigung (Windows Push Notification Service)
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.