Condividi tramite


Invio diretto

Invia una notifica direttamente a un handle del dispositivo (un token valido espresso dal tipo di notifica ). Gli utenti di questa API non devono usare registrazioni o installazioni. È invece possibile gestire tutti i dispositivi autonomamente e usare Hub di notifica di Azure esclusivamente come servizio pass-through per comunicare con i vari servizi di notifica push.

Importante

Firebase Cloud Messaging (FCM) è un servizio che, tra le altre cose, facilita agli sviluppatori l'invio di notifiche push ai dispositivi Android supportati da Google Play. Hub di notifica di Azure comunica attualmente con FCM usando il protocollo HTTP legacy. FCM v1 è un'API aggiornata che offre più funzionalità e funzionalità. Google ha annunciato che stanno deprecare HTTP legacy FCM e smetterà di supportarlo il 20 giugno 2024. Pertanto, gli sviluppatori che usano Hub di notifica di Azure per comunicare con i dispositivi Android supportati da Google Play, dovranno quindi eseguire la migrazione delle applicazioni e dei payload di notifica al formato più recente. Hub di notifica di Azure continuerà a supportare HTTP legacy FCM fino a quando Google smette di accettare le richieste. Al termine della nuova integrazione FCM, Hub di notifica di Azure annuncia quando è possibile iniziare la migrazione. Per altre informazioni, vedere la procedura di migrazione in questo articolo.

Richiesta

Metodo URI richiesta Versione HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 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 della firma di accesso condiviso con il bus di servizio.
Content-Type Impostare l'intestazione Content-Type in base al servizio di notifica della piattaforma di destinazione:
  • WNS: impostato su application/json; charset=utf-8 o application/xml. Se il tipo di notifica (X-WNS-Type) è "wns/raw", impostato su application/octet-stream.
  • GCM e APNS: impostare su application/json; charset=utf-8.
  • MPNS: impostato su application/xml;charset=utf-8.
ServiceBusNotification-DeviceHandle Handle del dispositivo PNS.
ServiceBusNotification-Tags {identificatore di tag singolo} (facoltativo)
ServiceBusNotification-Format Impostare su uno dei valori PlatformType validi seguenti: windows, apple, gcm, windowsphone, adm, nokiaxbaidu
x-ms-version 2015-04 (supportato da 2015-01 e versioni successive)

Testo della richiesta

In base al tipo di piattaforma, il corpo della richiesta modifica. Fare riferimento ai formati del corpo per ogni singola piattaforma nelle API REST di invio native.

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta. Il corpo della risposta viene restituito in caso di esito positivo.

Codici di risposta

Codice Descrizione
201 Messaggio inviato correttamente.
400 La richiesta non è valida( ad esempio, intestazioni di routing non valide, tipo di contenuto non valido, dimensioni del messaggio superiori a un formato di 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

Quando si usa HTTP 1.1, il feedback PNS non funziona quando si usa l'autenticazione basata su certificato; non restituisce dati. Usare l'autenticazione basata su token.

Intestazione risposta Descrizione
Content-Type application/xml; charset=utf-8
Posizione Questa intestazione è disponibile solo per Hub di notifica di livello Standard.

Questa intestazione contiene l'ID del messaggio di notifica. Viene usato con i dati di telemetria per messaggio: ottenere i dati di telemetria dei messaggi di notifica e correlare il feedback PNS. L'intestazione del percorso usa il formato seguente:

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

Corpo della risposta

Nessuno.

Passaggi successivi