Delen via

Een systeemeigen apns-melding (Apple Platform Notification Services) verzenden

  • Artikel

Hiermee wordt een systeemeigen APNS-melding verzonden via een Notification Hub.

Aanvraag

Methode Aanvraag-URI HTTP-versie
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 HTTP/1.1

Aanvraagheaders

In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.

Aanvraagheader Description
Autorisatie SAS-token gegenereerd zoals opgegeven in Shared Access Signature Authentication met Service Bus.
Content-Type Ingesteld op application/json;charset=utf-8.
ServiceBusNotification-Tags {single tag identifier} (optioneel)
ServiceBusNotification-Format Ingesteld op apple.
ServiceBusNotification-Apns-Expiry Apns verlopen in W3C DTF, JJJJ-MM-DDThh:mmTZD (bijvoorbeeld 1997-07-16T19:20+01:00).

Aanvraagbody

De aanvraagbody is een XML-document zoals opgegeven door Apple. Bijvoorbeeld:

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

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Antwoordcodes

Code Description
200 Het bericht is verzonden.
400 De aanvraag is onjuist ingedeeld (bijvoorbeeld ongeldige routeringsheaders, ongeldig inhoudstype, bericht overschrijdt de grootte, ongeldige berichtindeling).
401 Autorisatiefout. De toegangssleutel is onjuist.
403 Quotum overschreden of bericht is te groot; het bericht is geweigerd.
404 Geen berichtbranch op de URI.
413 Aangevraagde entiteit is te groot. De berichtgrootte mag niet groter zijn dan 64 kB.

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Antwoordheader Beschrijving
Locatie Deze header is alleen beschikbaar voor Notification Hubs van de Standard-laag.

Deze koptekst bevat de meldingsbericht-id. Deze wordt gebruikt met telemetrie per bericht: Telemetrie van meldingsberichten ophalen en PNS-feedback correleren. De locatieheader heeft de volgende indeling:

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

Hoofdtekst van de reactie

Geen.

Zie ook

Directe batchverzending
Een systeemeigen APNS-melding verzenden
Een systeemeigen MPNS-melding verzenden
Een systeemeigen WNS-melding verzendenEen sjabloonmelding verzenden