Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.