Envoyer une notification native WNS (Windows Push Notification Service)
Envoie une notification native WNS via un hub de notification.
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 SAP généré comme spécifié dans Authentification par signature d’accès partagé avec Service Bus. |
| Content-Type | A la valeur application/json;charset=utf-8 ou application/xml. Si le type de notification (X-WNS-Type) est wns/raw, défini sur application/octet-stream. |
| ServiceBusNotification-Tags |
{single tag identifier} (facultatif) |
| ServiceBusNotification-Format | Paramètre à définir sur windows |
| X-WNS- | Tous les en-têtes commençant par X-WNS seront transférés vers WNS. |
Corps de la demande
Le corps de la requête est un document XML tel que spécifié par WNS. Si la notification est de type « wns/raw », le corps est n’importe quel texte jusqu’à 5 Ko. Par exemple :
<?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>
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, taille supérieure du message, format de message incorrect). |
| 401 | Échec de l'autorisation. La clé d’accès était incorrecte. |
| 403 | Quota dépassé ou message trop important ; message a été rejeté. |
| 404 | Aucune branche de message au niveau de l’URI. |
| 413 | Entité demandée trop grande. La taille du message ne peut pas dépasser 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 les données de télémétrie et de corrélation des commentaires PNS par message. 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.