Condividi tramite

Inviare una notifica nativa di Apple Platform Notification Services (APNS)

  • Articolo

Invia una notifica nativa APNS tramite un hub di notifica.

Richiesta

Metodo URI richiesta Versione HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 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 su application/json;charset=utf-8.
ServiceBusNotification-Tags {single tag identifier} (facoltativo)
ServiceBusNotification-Format Impostare su apple.
ServiceBusNotification-Apns-Expiry Apns scade in W3C DTF, AAAA-MM-GGThh:mmTZD (ad esempio, 1997-07-16T19:20+01:00).

Testo della richiesta

Il corpo della richiesta è un documento XML come specificato da Apple. Ad esempio:

    { 
        "aps" : { 
            "alert" : " This is my toast message for iOS!", 
        }, 
    }

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codici di risposta

Codice Descrizione
200 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

Intestazione risposta Descrizione
Location Questa intestazione è disponibile solo per Hub di notifica di livello Standard.

Questa intestazione conterrà l'ID 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

No.

Vedere anche

Invio batch diretto
Inviare una notifica nativa APNS
Inviare una notifica nativa MPNS
Inviare una notifica nativa WNSInviare una notifica modello