Inviare una notifica nativa di Windows Push Notification Service (WNS)

Articolo
05/26/2023

Invia una notifica nativa WNS tramite un hub di notifica.

Richiesta

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

Intestazioni della richiesta

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

Intestazione della richiesta	Descrizione
Autorizzazione	Token di firma di accesso condiviso generato come specificato in Autenticazione firma di accesso condiviso con il bus di servizio.
Content-Type	Impostare su `application/json;charset=utf-8` o `application/xml`. Se il tipo di notifica (`X-WNS-Type`) è `wns/raw`, impostato su `application/octet-stream`.
ServiceBusNotification-Tags	`{single tag identifier}` (facoltativo)
ServiceBusNotification-Format	Impostare su `windows`
X-WNS-	Tutte le intestazioni che iniziano con X-WNS verranno inoltrate a WNS.

Testo della richiesta

Il corpo della richiesta è un documento XML come specificato da WNS. Se la notifica è di tipo "wns/raw", il corpo è qualsiasi testo fino a 5 Kb. Ad esempio:

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

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codici di risposta

Codice	Descrizione
200	Messaggio inviato correttamente.
400	La richiesta non è valida( ad esempio, intestazioni di routing non valide, non tipo di contenuto valido, il messaggio supera le dimensioni, il formato del messaggio non valido).
401	Errore di autorizzazione. La chiave di accesso non è corretta.
403	Quota superata o messaggio troppo grande; messaggio rifiutato.
404	Nessun ramo di messaggio nell'URI.
413	Entità richiesta troppo grande. Le dimensioni del messaggio non possono essere superiori a 64 Kb.

Per informazioni sui codici di stato, vedere Codici di stato e di errore.

Intestazioni di risposta

Intestazione risposta	Descrizione
Location	Questa intestazione è disponibile solo per Hub di notifica livello Standard. Questa intestazione conterrà l'ID messaggio di notifica. Viene usato con i dati di telemetria dei messaggi e correlando feedback PNS. L'intestazione della posizione usa il formato seguente: `https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04`

Corpo della risposta

No.

Condividi tramite