Direktes Senden

  • Artikel

Sendet eine Benachrichtigung direkt an ein Gerätehandle (ein gültiges Token, wie durch den Benachrichtigungstyp ausgedrückt). Benutzer dieser API müssen keine Registrierungen oder Installationen verwenden. Stattdessen verwalten Sie alle Geräte selbst und verwenden Azure Notification Hubs ausschließlich als Passthrough-Dienst, um mit den verschiedenen Push Notification Services zu kommunizieren.

Wichtig

Firebase Cloud Messaging (FCM) ist ein Dienst, der es Entwicklern unter anderem ermöglicht, Push-Benachrichtigungen an von Google Play unterstützte Android-Geräte zu senden. Azure Notification Hubs kommuniziert derzeit mit FCM über das alte HTTP-Protokoll. FCM v1 ist eine aktualisierte API, die mehr Funktionen und Möglichkeiten bietet. Google hat angekündigt, dass FCM Legacy HTTP veraltet ist und ab dem 20. Juni 2024 nicht mehr unterstützt wird. Daher müssen Entwickler, die derzeit Azure Notification Hubs für die Kommunikation mit von Google Play unterstützten Android-Geräten verwenden, ihre Anwendungen und Benachrichtigungs-Payloads auf das neuere Format umstellen. Azure Notification Hubs wird weiterhin FCM Legacy HTTP unterstützen, bis Google keine Anforderungen mehr annimmt. Sobald die neue FCM-Integration abgeschlossen ist, wird Azure Notification Hubs bekannt geben, wann Sie mit der Migration beginnen können. Weitere Informationen finden Sie in den Migrationsschritten in diesem Artikel.

Anforderung

Methode Anforderungs-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 erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader BESCHREIBUNG
Authorization SAS-Token generiert, wie in Shared Access Signature Authentication with Service Bus angegeben.
Content-Type Legen Sie den Content-Type-Header basierend auf dem Benachrichtigungsdienst der Zielplattform fest:
  • WNS: Auf application/json festgelegt; charset=utf-8 oder application/xml. Wenn der Benachrichtigungstyp (X-WNS-Type) "wns/raw" lautet, legen Sie auf application/octet-stream fest.
  • GCM und APNS: Auf application/json festgelegt; charset=utf-8.
  • MPNS: Legen Sie auf application/xml;charset=utf-8 fest.
ServiceBusNotification-DeviceHandle Das PNS-Gerätehandle.
ServiceBusNotification-Tags {Single Tag Identifier} (optional)
ServiceBusNotification-Format Legen Sie auf einen der folgenden gültigen PlatformType-Werte fest: windows, apple, gcm, windowsphoneadm, , , nokiaxbaidu
x-ms-version 2015-04 (unterstützt von 2015-01 und höher)

Anforderungstext

Basierend auf dem Plattformtyp ändert sich das Format des Anforderungstexts. Weitere Informationen finden Sie in den Textformaten für jede einzelne Plattform in nativen Sende-REST-APIs.

Antwort

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

Antwortcodes

Code BESCHREIBUNG
201 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

Bei Verwendung von HTTP 1.1 funktioniert das PNS-Feedback nicht, wenn die zertifikatbasierte Authentifizierung verwendet wird. Es werden keine Daten zurückgegeben. Verwenden der tokenbasierten Authentifizierung.

Antwortheader BESCHREIBUNG
Content-Type application/xml; charset=utf-8
Standort Dieser Header ist nur für Notification Hubs im Standard-Tarif verfügbar.

Dieser Header enthält die Benachrichtigungs-ID. Es wird mit Nachrichtentelemetriedaten verwendet: Abrufen von Benachrichtigungsnachrichtentelemetriedaten und Korrelieren von PNS-Feedback. 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.

Nächste Schritte