Partager via


Envoyer une notification native du service de notification Push Microsoft (MPNS)

Envoie une notification MPNS native via un hub de notification.

Important

Le Service de notifications Push Microsoft (MPNS, Microsoft Push Notification Service) est déconseillé et n’est plus pris en charge.

Requête

Méthode URI de demande Version HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 HTTP/1.1

En-têtes de requête

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.

En-tête de requête Description
Autorisation Jeton SAS généré comme spécifié dans Authentification par signature d’accès partagé avec Service Bus.
Content-Type Défini sur application/xml;charset=utf-8.
ServiceBusNotification-Tags {single tag identifier} (facultatif)
ServiceBusNotification-Format Paramètre à définir sur windowsphone
X-* Tous les en-têtes commençant par X- sont transférés à MPNS. Consultez Notifications Push pour Windows Phone 8.

Corps de la demande

Le corps de la demande est un document XML tel que spécifié par MPNS. Si la notification est une notification brute, le corps est n’importe quel texte jusqu’à 1 Ko. Par exemple :

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

response

La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.

Codes de réponse

Code Description
200 Message envoyé avec succès.
400 La requête est incorrecte (par exemple, en-têtes de routage non valides, type de contenu non valide, message dépasse la taille, format de message incorrect).
401 Échec de l'autorisation. La clé d’accès était incorrecte.
403 Quota dépassé ou message trop grand ; message a été rejeté.
404 Aucune branche de message au niveau de l’URI.
413 Entité demandée trop volumineuse. La taille du message ne peut pas être supérieure à 64 Ko.

Pour plus d’informations sur les codes status, consultez Codes d’état et d’erreur.

En-têtes de réponse

En-tête de réponse Description
Emplacement Cet en-tête est uniquement disponible pour les Hubs de notification de niveau Standard.

Cet en-tête contient l’ID du message de notification. Il est utilisé avec obtenir la télémétrie des messages de notification et mettre en corrélation les commentaires PNS. L’en-tête d’emplacement utilise le format suivant :

https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04

Response body

Aucun.

Voir aussi