Senden einer nativen MPNS-Benachrichtigung (Microsoft Push Notification Service)

Artikel
05/26/2023

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

Wichtig

Der Microsoft-Pushbenachrichtigungsdienst (MPNS) ist veraltet und wird nicht mehr unterstützt.

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 unter Shared Access Signature Authentication with Service Bus angegeben.
Content-Type	Legen Sie diese Option auf `application/xml;charset=utf-8` fest.
ServiceBusNotification-Tags	`{single tag identifier}` (optional)
ServiceBusNotification-Format	Legen Sie den Wert `windowsphone`
X-*	Alle Header ab X- werden an MPNS weitergeleitet. Siehe Pushbenachrichtigungen für Windows Phone 8.

Anforderungstext

Der Anforderungstext ist ein VON MPNS angegebenes XML-Dokument. Wenn es sich bei der Benachrichtigung um eine unformatierte Benachrichtigung handelt, ist der Textkörper ein beliebiger Text bis zu 1 KB. Beispiel:

<?xml version="1.0" encoding="utf-8"?>
<wp:Notification xmlns:wp="WPNotification" Version="2.0">
  <wp:Tile Id="[Tile ID]" Template="IconicTile">
    <wp:SmallIconImage [Action="Clear"]>[small Tile size URI]</wp:SmallIconImage>
    <wp:IconImage Action="Clear">[medium/wide Tile size URI]</wp:IconImage>
    <wp:WideContent1 Action="Clear">[1st row of content]</wp:WideContent1>
    <wp:WideContent2 Action="Clear">[2nd row of content]</wp:WideContent2>
    <wp:WideContent3 Action="Clear">[3rd row of content]</wp:WideContent3>
    <wp:Count Action="Clear">[count]</wp:Count>
    <wp:Title Action="Clear">[title]</wp:Title>
    <wp:BackgroundColor Action="Clear">[hex ARGB format color]</wp:BackgroundColor>
  </wp:Tile>
</wp:Notification>

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, Nachrichtengröße überschreitet Größe, fehlerhaftes 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

Antwortheader	BESCHREIBUNG
Standort	Dieser Header ist nur für Notification Hubs der Standardebene verfügbar. Dieser Header enthält die ID der Benachrichtigungsnachricht. Es wird verwendet, um Benachrichtigungsnachrichtentelemetrien abrufen und PNS-Feedback zu korrelieren. Der Speicherortheader verwendet das folgende Format: `https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04`

Dieser Header ist nur für Notification Hubs der Standardebene verfügbar.

Dieser Header enthält die ID der Benachrichtigungsnachricht. Es wird verwendet, um Benachrichtigungsnachrichtentelemetrien abrufen und PNS-Feedback zu korrelieren. 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