Trasmissione diretta

  • Articolo

 

Invia una notifica direttamente a un handle di dispositivo (un token valido come espresse in base al tipo di notifica). Questa API è disponibile solo per livello Standard Hub di notifica degli spazi dei nomi per i clienti che hanno richiesto l'API di essere abilitato per una richiesta di supporto. Gli utenti di questa API non è necessario utilizzare le registrazioni o installazioni. Invece, gli utenti di questa API gestiscono tutti i dispositivi nella propria e usare Hub di notifica di Azure esclusivamente la funzione di pass-through servizio per comunicare con i vari servizi di notifica Push.

Richiesta

Metodo URI della richiesta Versione HTTP
POST https://{Namespace}.ServiceBus.Windows.NET/{NotificationHub}/Messages/?Direct&API-Version=2015-04 HTTP/1.1

Intestazioni della richiesta

Nella tabella seguente vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

Intestazione della richiesta Descrizione
Autorizzazione Token generato come specificato nell'autenticazione della firma di accesso condiviso con Bus di servizio, o Bus di servizio autenticazione e autorizzazione con Microsoft Azure Active Directory Access Control (anche noto come Servizio di controllo di accesso o ACS).
Tipo di contenuto Impostare l'intestazione Content-Type in base al servizio notifica piattaforma destinazione riportata di seguito:

- WNS: Impostare su application/json; charset = utf-8 o application/xml. Se il tipo di notifica (X-WNS-Type) è "wns/raw", impostare su application/octet-stream.
- GCM e APN: Impostare su application/json; charset = utf-8.
- MPNS: Impostare su application/xml; charset = utf-8.
ServiceBusNotification DeviceHandle L'handle di dispositivo PNS.
Tag ServiceBusNotification {Identificatore tag singolo} (facoltativo)
Formato ServiceBusNotification Impostare un valore di tipo di piattaforma valido

- Windows
- Apple
- GCM
- windowsphone
- adm
- nokiax
- baidu
x-ms-version 2015-04 (supportato da 2015-01 e versioni successive)

Corpo della richiesta

I formati del corpo della richiesta in base al tipo di piattaforma, verranno modificato. Fare riferimento ai formati del corpo per ogni piattaforma singoli nativo delle API REST di trasmissione.

Risposta

La risposta include un codice di stato HTTP e un set di intestazioni di risposta. Corpo della risposta viene restituito in caso di riuscita.

Codici di risposta

Codice Descrizione
201 Messaggio inviato.
400 La richiesta non è valida (ad esempio, intestazioni di routing non è valide, non valide-tipo di contenuto, messaggio supera le dimensioni, il formato di messaggio non valido).
401 Errore di autorizzazione. La chiave di accesso non è corretta.
403 Quota superata o messaggio troppo grande; messaggio è stato rifiutato.
404 Nessun ramo di messaggio all'URI.
413 Entità richiesta troppo grande. La dimensione del messaggio non può essere superiori a 64Kb.

Per informazioni sui codici di stato, vedere stato e codici di errore.

Intestazioni di risposta

Intestazione della risposta Descrizione
Tipo di contenuto applicazione/xml; charset = utf-8

Corpo della risposta

Il corpo della risposta sarà un NotificationOutcome in formato XML.

<NotificationOutcome xmlns="https://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
    <Success>1</Success>  
    <Failure>0</Failure>  
    <Results>  
        <RegistrationResult>  
            <ApplicationPlatform>xxx</ApplicationPlatform>  
            <PnsHandle>xxxxxxxxxxxxxxxxxxxxx</PnsHandle>  
            <RegistrationId>1233409859034-238942347293-2</RegistrationId>  
            <Outcome>The Notification was successfully sent to the Push Notification System</Outcome>  
        </RegistrationResult>  
    </Results>  
</NotificationOutcome>

Vedere anche

Invio di Batch in diretta
Inviare una notifica nativa di APNS
Inviare una notifica nativa di GCM
Inviare una notifica nativa MPNS
Inviare una notifica nativa di WNS