Udostępnij za pośrednictwem

Wysyłanie powiadomienia natywnego usługi powiadomień wypychanych systemu Windows (WNS)

  • Artykuł

Wysyła natywne powiadomienie usługi WNS 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 SAS wygenerowany zgodnie z określoną w artykule Uwierzytelnianie za pomocą sygnatury dostępu współdzielonego za pomocą usługi Service Bus.
Content-Type Ustaw application/json;charset=utf-8 lub application/xml. Jeśli typ powiadomienia (X-WNS-Type) ma wns/rawwartość , ustaw wartość application/octet-stream.
ServiceBusNotification-Tags {single tag identifier} (opcjonalnie)
ServiceBusNotification-Format Ustaw wartość windows
X-WNS— Wszystkie nagłówki rozpoczynające się od X-WNS będą przekazywane do usługi WNS.

Treść żądania

Treść żądania jest dokumentem XML określonym przez usługę WNS. Jeśli powiadomienie ma typ "wns/raw", treść jest dowolnym tekstem do 5 Kb. Na przykład:

<?xml version="1.0" encoding="utf-8" ?>
<toast>
    <visual lang="en-US">
        <binding template="ToastText01">
            <text id="1">
                This is my toast message for Win8!
            </text>
        </binding>
    </visual>
</toast>

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 wiadomości).
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ć dłuższy niż 64 Kb.

Aby uzyskać informacje o kodach stanu, zobacz Status and Error Codes (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 danymi telemetrycznymi komunikatów i korelowaniem opinii usługi 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ż