Skicka ett internt meddelande från Microsoft Push Notification Service (MPNS)

Artikel
05/26/2023

Skickar ett inbyggt MPNS-meddelande via en meddelandehubb.

Viktigt

Microsoft Push Notification Service (MPNS) har blivit inaktuell och stöds inte längre.

Förfrågan

Metod	URI för förfrågan	HTTP-version
POST	`https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01`	HTTP/1.1

Begärandehuvuden

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Begärandehuvud	Beskrivning
Auktorisering	SAS-token genereras enligt vad som anges i Signaturautentisering för delad åtkomst med Service Bus.
Content-Type	Ange till `application/xml;charset=utf-8`.
ServiceBusNotification-Tags	`{single tag identifier}` (valfritt)
ServiceBusNotification-Format	Ange till `windowsphone`
X-*	Alla rubriker som börjar med X- vidarebefordras till MPNS. Se Push-meddelanden för Windows Phone 8.

Begärandetext

Begärandetexten är ett XML-dokument som anges av MPNS. Om meddelandet är ett råmeddelande är brödtexten en text på upp till 1 kB. Exempel:

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

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Svarskoder

Kod	Description
200	Meddelandet har skickats.
400	Begäran är felaktigt (till exempel ogiltiga routningshuvuden, ogiltig innehållstyp, meddelande överskrider storlek, felaktigt meddelandeformat).
401	Auktoriseringsfel. Åtkomstnyckeln var felaktig.
403	Kvoten har överskridits eller meddelandet är för stort. meddelandet avvisades.
404	Ingen meddelandegren vid URI:n.
413	Begärd entitet är för stor. Meddelandestorleken får inte vara över 64 kB.

Information om statuskoder finns i Status och Felkoder.

Svarshuvuden

Svarsrubrik	Description
Location	Det här huvudet är bara tillgängligt för Notification Hubs på standardnivå. Det här huvudet innehåller meddelande-ID:t. Den används med telemetri för att hämta meddelanden och korrelera PNS-feedback. Platsrubriken använder följande format: `https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04`

Själva svaret

Inga.

Dela via