Odeslání nativního oznámení mpns (Microsoft Push Notification Service)

Článek
05/26/2023

Odešle nativní oznámení MPNS prostřednictvím centra oznámení.

Důležité

Služba MPNS (Microsoft Push Notification Service) je zastaralá a už se nepodporuje.

Žádost

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	`https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01`	HTTP/1.1

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku	Popis
Autorizace	Token SAS vygenerovaný podle specifikace v části Ověřování pomocí sdíleného přístupového podpisu pomocí služby Service Bus.
Typ obsahu	Nastavte na `application/xml;charset=utf-8`.
ServiceBusNotification-Tags	`{single tag identifier}` (volitelné)
ServiceBusNotification-Format	Nastavit na `windowsphone`
X-*	Všechna záhlaví začínající na X- se přepošla do MPNS. Viz Nabízená oznámení pro Windows Phone 8.

Text požadavku

Text požadavku je dokument XML určený službou MPNS. Pokud je oznámení nezpracované, text je libovolný text o velikosti až 1 kB. Příklad:

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

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Kódy odpovědí

Kód	Description
200	Zpráva byla úspěšně odeslána.
400	Požadavek je poškozený (například neplatné hlavičky směrování, neplatný typ obsahu, zpráva překračuje velikost, chybný formát zprávy).
401	Autorizace se nezdařila. Přístupový klíč byl nesprávný.
403	Překročení kvóty nebo příliš velká zpráva; zpráva byla odmítnuta.
404	V identifikátoru URI není žádná větev zprávy.
413	Požadovaná entita je příliš velká. Velikost zprávy nesmí být větší než 64 kB.

Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Hlavička odpovědi	Popis
Umístění	Tato hlavička je dostupná jenom pro Notification Hubs úrovně Standard. Toto záhlaví bude obsahovat ID zprávy oznámení. Používá se pro získání telemetrie oznámení a korelaci zpětné vazby systému PNS. Hlavička umístění používá následující formát: `https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04`

Text odpovědi

Žádné

Sdílet prostřednictvím