Inviare una notifica nativa di Microsoft Push Notification Service (MPNS)

Articolo
05/26/2023

Invia una notifica nativa MPNS tramite un hub di notifica.

Importante

Microsoft Push Notification Service (MPNS) è stato deprecato e non è più supportato.

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/xml;charset=utf-8`.
ServiceBusNotification-Tags	`{single tag identifier}` (facoltativo)
ServiceBusNotification-Format	Impostare su `windowsphone`
X-*	Tutte le intestazioni che iniziano con X- verranno inoltrate a MPNS. Vedere Notifiche push per Windows Phone 8.

Testo della richiesta

Il corpo della richiesta è un documento XML come specificato da MPNS. Se la notifica è una notifica non elaborata, il corpo è qualsiasi testo fino a 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 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

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 Ottenere i dati di telemetria dei messaggi di notifica e correlare il 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`

Questa intestazione è disponibile solo per Hub di notifica livello Standard.

Questa intestazione conterrà l'ID messaggio di notifica. Viene usato con Ottenere i dati di telemetria dei messaggi di notifica e correlare il 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