Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 | 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.