Partager via

Envoi direct

  • Article

Envoie une notification directement à un handle d’appareil (jeton valide tel qu’exprimé par le type de notification ). Les utilisateurs de cette API n’ont pas besoin d’utiliser des inscriptions ou des installations. Au lieu de cela, vous gérez tous les appareils seuls et utilisez Azure Notification Hubs uniquement en tant que service direct pour communiquer avec les différents services de notification Push.

Important

Firebase Cloud Messaging (FCM) est un service facilitant, entre autres, l’envoi de notifications Push par des développeurs aux appareils Android pris en charge par Google Play. Azure Notification Hubs communique actuellement avec FCM en utilisant le protocole HTTP hérité. FCM v1 est une API mise à jour offrant davantage de fonctionnalités et de caractéristiques. Google a annoncé la fin du protocole HTTP hérité de FCM et va cesser de le prendre en charge le 20 juin 2024. Par conséquent, les développeurs, utilisant actuellement Azure Notification Hubs pour communiquer avec des appareils Android pris en charge par Google Play, doivent effectuer une migration de leurs applications et charges utiles de notifications vers le format le plus récent. Azure Notification Hubs va continuer à prendre en charge le protocole HTTP hérité de FCM jusqu’à ce que Google cesse d’accepter des requêtes. Une fois la nouvelle intégration FCM terminée, Azure Notification Hubs vous annoncera quand vous pourrez commencer la migration. Pour plus d’informations, consultez les étapes de migration de cet article.

Requête

Méthode URI de demande Version HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 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 Définissez l’en-tête Content-Type en fonction du service de notification de plateforme cible :
  • WNS : défini sur application/json ; charset=utf-8 ou application/xml. Si le type de notification (type X-WNS) est « wns/raw », définissez sur application/octet-stream.
  • GCM et APNS : défini sur application/json ; charset=utf-8.
  • MPNS : défini sur application/xml ;charset=utf-8.
ServiceBusNotification-DeviceHandle Handle d’appareil PNS.
ServiceBusNotification-Tags {identificateur de balise unique} (facultatif)
ServiceBusNotification-Format Définissez sur l’une des valeurs PlatformType valides suivantes : windows, apple, gcm, windowsphone, adm, , nokiaxbaidu
x-ms-version 2015-04 (pris en charge par 2015-01 et versions ultérieures)

Corps de la demande

En fonction du type de plateforme, le format du corps de la requête change. Reportez-vous aux formats de corps pour chaque plateforme individuelle dans les API REST d’envoi natives.

response

La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse. Le corps de la réponse est retourné en cas de réussite.

Codes de réponse

Code Description
201 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

Lors de l’utilisation de HTTP 1.1, les commentaires PNS ne fonctionnent pas lors de l’utilisation de l’authentification basée sur les certificats ; il ne retourne aucune donnée. Utilisez l’authentification basée sur un jeton.

En-tête de réponse Description
Content-Type application/xml; charset=utf-8
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 par message : Obtenir la télémétrie des messages de notification et corrélater 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.

Étapes suivantes