Udostępnij za pośrednictwem

Wysyłanie powiadomień natywnych usług Apple Platform Notification Services (APNS)

  • Artykuł

Wysyła powiadomienie natywne usługi APNS za pośrednictwem centrum powiadomień.

Żądanie

Metoda Identyfikator URI żądania Wersja protokołu HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 HTTP/1.1

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania Opis
Autoryzacja Token sygnatury dostępu współdzielonego wygenerowany zgodnie z uwierzytelnianiem sygnatury dostępu współdzielonego za pomocą usługi Service Bus.
Content-Type Ustaw wartość application/json;charset=utf-8.
ServiceBusNotification-Tags {single tag identifier} (opcjonalnie)
ServiceBusNotification-Format Ustaw wartość apple.
ServiceBusNotification-Apns-Expiry Wygaśnięcie apns w W3C DTF, RRRR-MM-DDThh:mmTZD (na przykład 1997-07-16T19:20+01:00).

Treść żądania

Treść żądania jest dokumentem XML określonym przez firmę Apple. Na przykład:

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

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kody odpowiedzi

Kod Opis
200 Wiadomość została pomyślnie wysłana.
400 Żądanie jest źle sformułowane (na przykład nieprawidłowe nagłówki routingu, nieprawidłowy typ zawartości, komunikat przekracza rozmiar, nieprawidłowy format komunikatu).
401 Niepowodzenie autoryzacji. Klucz dostępu był niepoprawny.
403 Przekroczono limit przydziału lub zbyt duży komunikat; wiadomość została odrzucona.
404 Brak gałęzi komunikatów w identyfikatorze URI.
413 Zażądano zbyt dużej jednostki. Rozmiar komunikatu nie może być większy niż 64 KB.

Aby uzyskać informacje o kodach stanu, zobacz Kody stanu i błędów.

Nagłówki odpowiedzi

Nagłówek odpowiedzi Opis
Lokalizacja Ten nagłówek jest dostępny tylko dla usługi Notification Hubs w warstwie Standardowa.

Ten nagłówek będzie zawierać identyfikator komunikatu powiadomienia. Jest on używany z telemetrią dla komunikatów: pobieranie telemetrii komunikatów powiadomień i korelowanie opinii pnS. Nagłówek lokalizacji używa następującego formatu:

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

Treść odpowiedzi

Brak.

Zobacz też

Bezpośrednie wysyłanie wsadowe
Wysyłanie powiadomienia natywnego usługi APNS
Wysyłanie powiadomienia natywnego usługi MPNS
Wysyłanie powiadomienia natywnego usługi WNS Wysyłanie powiadomieniao szablonie