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.