Udostępnij za pośrednictwem

Wysyłanie powiadomienia natywnego usługi powiadomień wypychanych firmy Microsoft (MPNS)

  • Artykuł

Wysyła natywne powiadomienie MPNS za pośrednictwem centrum powiadomień.

Ważne

Usługa powiadomień wypychanych firmy Microsoft (MPNS) jest przestarzała i nie jest już obsługiwana.

Żą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 wartość application/xml;charset=utf-8.
ServiceBusNotification-Tags {single tag identifier} (opcjonalnie)
ServiceBusNotification-Format Ustaw wartość windowsphone
X-* Wszystkie nagłówki rozpoczynające się od X- będą przekazywane do sieci MPNS. Zobacz Powiadomienia wypychane dla Windows Phone 8.

Treść żądania

Treść żądania jest dokumentem XML określonym przez usługę MPNS. Jeśli powiadomienie jest nieprzetworzonym powiadomieniem, treść to dowolny tekst do 1 Kb. Na przykład:

<?xml version="1.0" encoding="utf-8"?>
<wp:Notification xmlns:wp="WPNotification" Version="2.0">
  <wp:Tile Id="[Tile ID]" Template="IconicTile">
    <wp:SmallIconImage [Action="Clear"]>[small Tile size URI]</wp:SmallIconImage>
    <wp:IconImage Action="Clear">[medium/wide Tile size URI]</wp:IconImage>
    <wp:WideContent1 Action="Clear">[1st row of content]</wp:WideContent1>
    <wp:WideContent2 Action="Clear">[2nd row of content]</wp:WideContent2>
    <wp:WideContent3 Action="Clear">[3rd row of content]</wp:WideContent3>
    <wp:Count Action="Clear">[count]</wp:Count>
    <wp:Title Action="Clear">[title]</wp:Title>
    <wp:BackgroundColor Action="Clear">[hex ARGB format color]</wp:BackgroundColor>
  </wp:Tile>
</wp:Notification>

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 funkcją Uzyskiwanie danych telemetrycznych komunikatów powiadomień 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ż