Dela via

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

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.

Se även

  • Last updated on