Een systeemeigen melding van Microsoft Push Notification Service (MPNS) verzenden

Artikel
05/26/2023

Hiermee wordt een systeemeigen MPNS-melding verzonden via een Notification Hub.

Belangrijk

Microsoft Push Notification Service (MPNS) is afgeschaft en wordt niet meer ondersteund.

Aanvraag

Methode	Aanvraag-URI	HTTP-versie
POST	`https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01`	HTTP/1.1

Aanvraagheaders

In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.

Aanvraagheader	Description
Autorisatie	SAS-token gegenereerd zoals opgegeven in Shared Access Signature Authentication met Service Bus.
Content-Type	Ingesteld op `application/xml;charset=utf-8`.
ServiceBusNotification-Tags	`{single tag identifier}` (optioneel)
ServiceBusNotification-Format	Ingesteld op `windowsphone`
X-*	Alle headers die beginnen met X- worden doorgestuurd naar MPNS. Zie Pushmeldingen voor Windows Phone 8.

Aanvraagbody

De aanvraagbody is een XML-document zoals opgegeven door MPNS. Als de melding een onbewerkte melding is, is de hoofdtekst tekst van maximaal 1 kB. Bijvoorbeeld:

<?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>

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Antwoordcodes

Code	Description
200	Het bericht is verzonden.
400	De aanvraag is onjuist ingedeeld (bijvoorbeeld ongeldige routeringsheaders, ongeldig inhoudstype, bericht overschrijdt de grootte, ongeldige berichtindeling).
401	Autorisatiefout. De toegangssleutel is onjuist.
403	Quotum overschreden of bericht is te groot; het bericht is geweigerd.
404	Geen berichtbranch op de URI.
413	Aangevraagde entiteit is te groot. De berichtgrootte mag niet groter zijn dan 64 kB.

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Antwoordheader	Beschrijving
Locatie	Deze header is alleen beschikbaar voor Notification Hubs van de Standard-laag. Deze koptekst bevat de meldingsbericht-id. Deze wordt gebruikt met telemetrie van meldingsberichten ophalen en het correleren van PNS-feedback. De locatieheader heeft de volgende indeling: `https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04`

Hoofdtekst van de reactie

Geen.

Delen via