Udostępnij za pośrednictwem

Bezpośrednie wysyłanie

  • Artykuł

Wysyła powiadomienie bezpośrednio do dojścia urządzenia (prawidłowy token wyrażony przez typ powiadomienia ). Użytkownicy tego interfejsu API nie muszą używać rejestracji ani instalacji. Zamiast tego zarządzasz wszystkimi urządzeniami samodzielnie i używasz usługi Azure Notification Hubs wyłącznie jako usługi przekazywanej w celu komunikowania się z różnymi usługami powiadomień wypychanych.

Ważne

Firebase Cloud Messaging (FCM) to między innymi usługa, która ułatwia deweloperom wysyłanie powiadomień wypychanych do urządzeń z systemem Android obsługiwanych przez sklep Google Play. Usługa Azure Notification Hubs obecnie komunikuje się z usługą FCM przy użyciu starszego protokołu HTTP. FCM v1 to zaktualizowany interfejs API, który oferuje więcej funkcji i możliwości. Firma Google ogłosiła, że w dniu 20 czerwca 2024 r. wycofa obsługę starszego protokołu HTTP w usłudze FCM. W związku z tym deweloperzy, którzy używają usługi Azure Notification Hubs do komunikowania się z urządzeniami z systemem Android obsługiwanymi przez sklep Google Play, będą musieli zmigrować aplikacje i ładunki powiadomień do nowszego formatu. Usługa Azure Notification Hubs będzie nadal obsługiwać starsze protokoły HTTP usługi FCM, dopóki firma Google nie przestanie akceptować żądań. Po zakończeniu integracji z usługą FCM usługa Azure Notification Hubs ogłosi, kiedy będzie można rozpocząć migrację. Aby uzyskać więcej informacji, zobacz kroki migracji w tym artykule.

Żądanie

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 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 nagłówek Content-Type na podstawie usługi powiadomień platformy docelowej:
  • WNS: ustaw wartość application/json; charset=utf-8 lub application/xml. Jeśli typ powiadomienia (X-WNS-Type) to "wns/raw", ustaw wartość application/octet-stream.
  • GCM i APNS: ustaw wartość application/json; charset=utf-8.
  • MPNS: ustaw wartość application/xml;charset=utf-8.
ServiceBusNotification-DeviceHandle Dojście urządzenia PNS.
ServiceBusNotification-Tags {identyfikator pojedynczego tagu} (opcjonalnie)
ServiceBusNotification-Format Ustaw na jedną z następujących prawidłowych wartości Typu platformy: windows, , applegcm, windowsphone, adm, , nokiaxbaidu
x-ms-version 2015-04 (Obsługiwane przez 2015-01 i nowsze)

Treść żądania

Na podstawie typu platformy formaty treści żądania zmieniają się. Zapoznaj się z formatami treści dla każdej platformy w natywnych interfejsach API REST wysyłania.

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi. Treść odpowiedzi jest zwracana po pomyślnym zakończeniu.

Kody odpowiedzi

Kod Opis
201 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

W przypadku korzystania z protokołu HTTP 1.1 opinia usługi PNS nie działa podczas korzystania z uwierzytelniania opartego na certyfikatach; nie zwraca żadnych danych. Użyj uwierzytelniania opartego na tokenach.

Nagłówek odpowiedzi Opis
Content-Type application/xml; charset=utf-8
Lokalizacja Ten nagłówek jest dostępny tylko dla usługi Notification Hubs w warstwie Standardowa.

Ten nagłówek zawiera identyfikator komunikatu powiadomienia. Jest on używany z telemetrią dla poszczególnych wiadomości: uzyskiwanie danych telemetrycznych komunikatów powiadomień i korelowanie 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.

Następne kroki