Freigeben über

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-streamfest.
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.

Weitere Informationen

  • Last updated on