Inviare una notifica nativa di WNS
Invia una notifica nativa di WNS tramite un hub notifiche.
Richiesta
Metodo |
URI della 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 generato come specificato nell'autenticazione della firma di accesso condiviso con Bus di servizio oppure nell'autenticazione e nell'autorizzazione di Bus di servizio con Microsoft Azure Active Directory Access Control (anche noto come Servizio di controllo di accesso o ACS). |
Content-Type |
Impostare su application/json; charset = utf-8 o application/xml. Se il tipo di notifica (X-WNS-Type) è "wns/raw", impostare su application/octet-stream. |
ServiceBusNotification-Tags |
{identificatore tag singolo} (facoltativo). |
ServiceBusNotification-Format |
Viene impostata su windows. |
X-WNS-* |
Tutte le intestazioni che iniziano con X-WNS vengono inoltrate a WNS. Vedere, X - WNS-* riferimento |
Corpo della richiesta
Il corpo della richiesta è un documento XML conforme alle specifiche di WNS. Se il tipo di notifica è "wns/raw", il corpo è un qualsiasi testo con dimensione massima di 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. |
400 |
Formato della richiesta non corretto, ad esempio intestazioni di routing non valide, tipo di contenuto non valido, dimensione eccessiva del messaggio, formato non corretto del messaggio. |
401 |
Errore di autorizzazione. Chiave di accesso non corretta. |
403 |
Quota superata o messaggio troppo grande. Il messaggio è stato rifiutato. |
404 |
Nessun ramo di messaggio nell'URI. |
413 |
Entità richiesta troppo grande. La dimensione del messaggio non può superare 64 KB. |
Per informazioni sui codici di stato, vedere Codici ed errori di stato.
Intestazioni della risposta
Nessuna.
Corpo della risposta
Nessuna.