Een systeemeigen melding van Windows Push Notification Service (WNS) verzenden

Artikel
05/26/2023

Hiermee wordt een systeemeigen WNS-melding verzonden via een Notification Hub.

Aanvraag

Methode	Aanvraag-URI	HTTP-versie
POST	`https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01`	HTTP/1.1

Aanvraagheaders

In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.

Aanvraagheader	Description
Autorisatie	SAS-token gegenereerd zoals opgegeven in Shared Access Signature Authentication met Service Bus.
Content-Type	Stel in op `application/json;charset=utf-8` of `application/xml`. Als het meldingstype (`X-WNS-Type`) is, stelt `wns/raw`u in op `application/octet-stream`.
ServiceBusNotification-Tags	`{single tag identifier}` (optioneel)
ServiceBusNotification-Format	Ingesteld op `windows`
X-WNS-	Alle headers die beginnen met X-WNS, worden doorgestuurd naar WNS.

Aanvraagbody

De aanvraagbody is een XML-document zoals opgegeven door WNS. Als de melding van het type 'wns/raw' is, is de hoofdtekst een tekst van maximaal 5 kB. Bijvoorbeeld:

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

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Antwoordcodes

Code	Description
200	Het bericht is verzonden.
400	De aanvraag is onjuist ingedeeld (bijvoorbeeld ongeldige routeringsheaders, ongeldig inhoudstype, bericht overschrijdt de grootte, ongeldige berichtindeling).
401	Autorisatiefout. De toegangssleutel is onjuist.
403	Quotum overschreden of bericht is te groot; het bericht is geweigerd.
404	Geen berichtbranch op de URI.
413	Aangevraagde entiteit is te groot. De berichtgrootte mag niet groter zijn dan 64 kB.

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Antwoordheader	Beschrijving
Locatie	Deze header is alleen beschikbaar voor Notification Hubs van de Standard-laag. Deze koptekst bevat de meldingsbericht-id. Het wordt gebruikt met telemetrie per bericht en het correleren van PNS-feedback. De locatieheader heeft de volgende indeling: `https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04`

Hoofdtekst van de reactie

Geen.

Delen via