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:
|
| 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.
- Inviare una notifica nativa APNS
- Inviare una notifica nativa di FCM
- Inviare una notifica nativa di GCM
- Inviare una notifica nativa MPNS
- Inviare una notifica nativa WNS
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.