Odeslání nativního oznámení Služby nabízených oznámení systému Windows (WNS)

Článek
05/26/2023

Odešle nativní oznámení služby WNS prostřednictvím centra oznámení.

Žá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 se vygeneruje tak, jak je uvedeno v části Ověřování pomocí sdíleného přístupového podpisu se službou Service Bus.
Typ obsahu	Nastavte na `application/json;charset=utf-8` nebo `application/xml`. Pokud je `wns/raw`typ oznámení (`X-WNS-Type`) , nastavte na `application/octet-stream`.
ServiceBusNotification-Tags	`{single tag identifier}` (volitelné)
ServiceBusNotification-Format	Nastavit na `windows`
X-WNS-	Všechna záhlaví začínající na X-WNS se přepošle do služby WNS.

Text požadavku

Text požadavku je dokument XML určený službou WNS. Pokud je oznámení typu "wns/raw", text je libovolný text až do velikosti 5 kB. Příklad:

<?xml version="1.0" encoding="utf-8" ?>
<toast>
    <visual lang="en-US">
        <binding template="ToastText01">
            <text id="1">
                This is my toast message for Win8!
            </text>
        </binding>
    </visual>
</toast>

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	Chyba autorizace. 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 centra oznámení úrovně Standard. Tato hlavička bude obsahovat ID zprávy oznámení. Používá se s telemetrií podle zpráv a korelací zpětné vazby 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