Inviare una notifica nativa di MPNS
Invia una notifica nativa di MPNS 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 |
Impostata su application/xml;charset=utf-8. |
ServiceBusNotification-Tags |
{identificatore tag singolo} (facoltativo). |
ServiceBusNotification-Format |
Impostata su windowsphone. |
X-* |
Tutte le intestazioni che iniziano con X- vengono inoltrate a MPNS. Vedere, di notifiche Push per Windows Phone 8. |
Corpo della richiesta
Il corpo della richiesta è un documento XML conforme alle specifiche di MPNS. Se il tipo di notifica è raw, il corpo è un qualsiasi testo con dimensione massima di 1 KB. Ad esempio:
<?xml version="1.0" encoding="utf-8"?> <wp:Notification xmlns:wp="WPNotification" Version="2.0"> <wp:Tile Id="[Tile ID]" Template="IconicTile"> <wp:SmallIconImage [Action="Clear"]>[small Tile size URI]</wp:SmallIconImage> <wp:IconImage Action="Clear">[medium/wide Tile size URI]</wp:IconImage> <wp:WideContent1 Action="Clear">[1st row of content]</wp:WideContent1> <wp:WideContent2 Action="Clear">[2nd row of content]</wp:WideContent2> <wp:WideContent3 Action="Clear">[3rd row of content]</wp:WideContent3> <wp:Count Action="Clear">[count]</wp:Count> <wp:Title Action="Clear">[title]</wp:Title> <wp:BackgroundColor Action="Clear">[hex ARGB format color]</wp:BackgroundColor> </wp:Tile> </wp:Notification>
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
Intestazione della risposta |
Descrizione |
---|---|
Location |
URI del messaggio di notifica.
|
Corpo della risposta
Nessuna.
Vedere anche
Inviare una notifica nativa di APNS
Inviare una notifica nativa di GCM
Inviare una notifica nativa di WNS
Inviare una notifica modello
Trasmissione diretta