Direkte Senden

Artikel
11/18/2016

Sendet eine Benachrichtigung direkt an ein Gerätehandle (ein gültiges Token als durch den Benachrichtigungstyp). Diese API ist nur verfügbar für Standardebene Notification Hub-Namespaces für welche Kunden angefordert wurden die API durch eine Supportanfrage aktiviert werden. Benutzer dieser API müssen keine Installationen oder Registrierungen verwenden. Benutzer dieser API wird stattdessen verwalten alle ihre eigenen Geräte und Azure Notification Hub zur Kommunikation mit den verschiedenen Push Notification Services ausschließlich als Pass-through-Dienst verwenden.

Anforderung

Methode	Anfrage-URI	HTTP-Version
POST	https://{Namespace}.Servicebus.Windows.NET/{NotificationHub}/Messages/?Direct&API-Version=2015-04	HTTP/1.1

Anforderungsheader

In der folgenden Tabelle werden die erforderlichen und optionalen Anforderungsheader beschrieben.

Anforderungsheader	Beschreibung
Autorisierung	Gemäß der SAS-Authentifizierung mit generierte Token Servicebus, oder Servicebus Authentifizierung und Autorisierung mit Zugriffssteuerung für Microsoft Azure Active Directory (auch Zugriffssteuerungsdienst oder ACS).
Content-Type	Legen Sie den Content-Type-Header, die basierend auf dem Ziel-Plattform Notification Service unten: - WNS: Legen Sie auf Application/Json; Charset = Utf-8 oder Application/Xml. Wenn der Benachrichtigungstyp (X-WNS-Typ) "Wns/raw" ist, legen Sie auf Application/Octet-Stream. - GCM und APNS: Legen Sie auf Application/Json; Charset = Utf-8. - MPNS: Legen Sie auf Application/Xml; Charset = Utf-8.
ServiceBusNotification DeviceHandle	Das Handle für die PNS.
ServiceBusNotification-Tags	{einzelner Tagbezeichner} (optional)
ServiceBusNotification-Format	Legen Sie auf einen gültigen Wert für den Plattformtyp - Windows - Apple - GCM - Windows Phone - ADM - nokiax - baidu
X-ms-version	2015-04 (unterstützt durch 2015-01 und höher)

Anforderungstext

Basierend auf den Typ der Plattform, ändert sich die Anforderung Text-Formate. Die Text-Formate für jede einzelne Plattform in systemeigenen senden REST-APIs finden Sie unter.

Antwort

Die Antwort enthält einen HTTP-Statuscode und einen Satz von Antwortheadern. Antworttext bei Erfolg zurückgegeben.

Antwortcodes

Code	Beschreibung
201	Die Nachricht wurde erfolgreich gesendet.
400	Die Anforderung ist falsch formatiert (z. B. keine gültigen Routingheader, kein gültiges Inhaltstyp, Nachrichten, Ungültiges Nachrichtenformat ist größer als).
401	Fehler bei der Autorisierung. Der Zugriffsschlüssel war falsch.
403	Das Kontingent wurde überschritten oder Nachricht zu groß. Nachricht wurde zurückgewiesen.
404	Kein nachrichtenzweig am URI.
413	Angeforderte Entität ist zu groß. Die Größe der Nachricht darf nicht größer als 64 Kb sein.

Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortheader

Antwort-Header	Beschreibung
Inhaltstyp	Anwendung/Xml; Charset = Utf-8

Antworttext

Der Antworttext ein NotificationOutcome im XML-Format.

<NotificationOutcome xmlns="https://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
    <Success>1</Success>  
    <Failure>0</Failure>  
    <Results>  
        <RegistrationResult>  
            <ApplicationPlatform>xxx</ApplicationPlatform>  
            <PnsHandle>xxxxxxxxxxxxxxxxxxxxx</PnsHandle>  
            <RegistrationId>1233409859034-238942347293-2</RegistrationId>  
            <Outcome>The Notification was successfully sent to the Push Notification System</Outcome>  
        </RegistrationResult>  
    </Results>  
</NotificationOutcome>

Siehe auch

Direkte Batch senden
Senden einer systemeigenen APNS-Benachrichtigung
Senden einer systemeigenen GCM-Benachrichtigung
Senden einer systemeigenen MPNS-Benachrichtigung
Senden einer systemeigenen WNS-Benachrichtigung

Freigeben über