Trasmissione diretta

Articolo
11/18/2016

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

Condividi tramite