Skicka ett internt WNS-meddelande (Windows Push Notification Service)

Artikel
05/26/2023

Skickar ett internt WNS-meddelande via en meddelandehubb.

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 som genereras enligt specifikationen i Signaturautentisering för delad åtkomst med Service Bus.
Content-Type	Ange till `application/json;charset=utf-8` eller `application/xml`. Om meddelandetypen (`X-WNS-Type`) är `wns/raw`anger du till `application/octet-stream`.
ServiceBusNotification-Tags	`{single tag identifier}` (valfritt)
ServiceBusNotification-Format	Ange till `windows`
X-WNS-	Alla rubriker som börjar med X-WNS vidarebefordras till WNS.

Begärandetext

Begärandetexten är ett XML-dokument som anges av WNS. Om meddelandet är av typen "wns/raw" är brödtexten en text på upp till 5 kB. Exempel:

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

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 felaktig (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	Den här rubriken är endast tillgänglig för Notification Hubs på standardnivå. Den här rubriken innehåller meddelande-ID:t för meddelanden. Den används med telemetri per meddelande 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