Freigeben über

Senden einer nativen APNS-Benachrichtigung (Apple Platform Notification Services)

  • Artikel

Sendet eine native APNS-Benachrichtigung über einen Notification Hub.

Anforderung

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

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader BESCHREIBUNG
Authorization SAS-Token generiert, wie unter Shared Access Signature Authentication with Service Bus angegeben.
Content-Type Legen Sie diese Option auf application/json;charset=utf-8 fest.
ServiceBusNotification-Tags {single tag identifier} (optional)
ServiceBusNotification-Format Legen Sie diese Option auf apple fest.
ServiceBusNotification-Apns-Expiry Apnen ablaufen in W3C DTF, JJJJ-MM-TTThh:mmTZD (z. B. 1997-07-16T19:20+01:00).

Anforderungstext

Der Anforderungstext ist ein VON Apple angegebenes XML-Dokument. Beispiel:

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

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Antwortcodes

Code BESCHREIBUNG
200 Nachricht erfolgreich gesendet.
400 Die Anforderung ist falsch formatiert (z. B. ungültige Routingheader, ungültiger Inhaltstyp, Nachrichtengröße überschreitet Größe, fehlerhaftes Nachrichtenformat).
401 Autorisierungsfehler Der Zugriffsschlüssel war falsch.
403 Kontingent überschritten oder Nachricht zu groß; Nachricht wurde abgelehnt.
404 Kein Nachrichtenbranch am URI.
413 Die angeforderte Entität ist zu groß. Die Nachrichtengröße darf nicht mehr als 64 KB betragen.

Informationen zu status Codes finden Sie unter Status- und Fehlercodes.

Antwortheader

Antwortheader BESCHREIBUNG
Standort Dieser Header ist nur für Notification Hubs der Standardebene verfügbar.

Dieser Header enthält die ID der Benachrichtigungsnachricht. Es wird mit Pro-Nachricht-Telemetrie verwendet: Abrufen von Benachrichtigungsnachrichtentelemetriedaten und Korrelieren von PNS-Feedback. Der Speicherortheader verwendet das folgende Format:

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

Antworttext

Keine.

Weitere Informationen

Direktes Senden von Batch
Senden einer nativen APNS-Benachrichtigung
Senden einer nativen MPNS-Benachrichtigung
Senden einer nativen WNS-BenachrichtigungSenden einer Vorlagenbenachrichtigung