Sdílet prostřednictvím

Přímé odeslání

  • Článek

Odešle oznámení přímo do popisovače zařízení (platný token vyjádřený typem oznámení ). Uživatelé tohoto rozhraní API nemusí používat registrace ani instalace. Místo toho spravujete všechna zařízení samostatně a používáte Azure Notification Hubs výhradně jako předávací službu ke komunikaci s různými službami nabízených oznámení.

Důležité

Firebase Cloud Messaging (FCM) je služba, která mimo jiné vývojářům usnadňuje odesílání nabízených oznámení do zařízení s Androidem podporovaných službou Google Play. Azure Notification Hubs v současné době komunikuje s FCM pomocí starší verze protokolu HTTP. FCM v1 je aktualizované rozhraní API, které nabízí více funkcí a možností. Společnost Google oznámila, že vyřazuje starší verzi PROTOKOLU HTTP FCM a 20. června 2024 ho přestane podporovat. Vývojáři, kteří dnes používají Azure Notification Hubs ke komunikaci se zařízeními s Androidem, která podporují Google Play, proto budou muset migrovat své aplikace a datové části oznámení do novějšího formátu. Azure Notification Hubs bude dál podporovat starší verzi PROTOKOLU HTTP FCM, dokud Google nepřestane přijímat žádosti. Po dokončení nové integrace FCM služba Azure Notification Hubs oznámí, kdy můžete zahájit migraci. Další podrobnosti najdete v postupu migrace v tomto článku.

Žádost

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 HTTP/1.1

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku Popis
Autorizace Token SAS se vygeneruje tak, jak je uvedeno v části Ověřování pomocí sdíleného přístupového podpisu se službou Service Bus.
Typ obsahu Nastavte hlavičku Content-Type na základě služby oznámení cílové platformy:
  • WNS: Nastavte na application/json; charset=utf-8 nebo application/xml. Pokud je typ oznámení (X-WNS-Type) "wns/raw", nastavte na application/octet-stream.
  • GCM a APNS: Nastaveno na application/json; charset=utf-8.
  • MPNS: Nastavte na application/xml;charset=utf-8.
ServiceBusNotification-DeviceHandle Popisovač zařízení PNS.
ServiceBusNotification-Tags {identifikátor jedné značky} (volitelné)
ServiceBusNotification-Format Nastavte jednu z následujících platných hodnot PlatformType: windows, apple, gcm, windowsphone, adm, nokiaxbaidu
x-ms-version 4. 2015 (podporováno v 1. 1. 2015 a novějším)

Text požadavku

V závislosti na typu platformy se formátuje text požadavku. Projděte si formáty textu pro každou jednotlivou platformu v nativních rozhraních REST API pro odesílání.

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi. Při úspěchu se vrátí text odpovědi.

Kódy odpovědí

Kód Description
201 Zpráva byla úspěšně odeslána.
400 Požadavek je poškozený (například neplatné hlavičky směrování, neplatný typ obsahu, zpráva překračuje velikost, chybný formát zprávy).
401 Chyba autorizace. Přístupový klíč byl nesprávný.
403 Překročení kvóty nebo příliš velká zpráva; zpráva byla odmítnuta.
404 V identifikátoru URI není žádná větev zprávy.
413 Požadovaná entita je příliš velká. Velikost zprávy nesmí být větší než 64 kB.

Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Při použití HTTP 1.1 nefunguje zpětná vazba PNS při použití ověřování založeného na certifikátech; nevrací žádná data. Použijte ověřování na základě tokenů.

Hlavička odpovědi Description
Typ obsahu application/xml; charset=utf-8
Umístění Tato hlavička je dostupná jenom pro centra oznámení úrovně Standard.

Tato hlavička obsahuje ID zprávy oznámení. Používá se s telemetrií pro jednotlivé zprávy: Získání telemetrie zpráv oznámení a korelace zpětné vazby PNS. Hlavička umístění používá následující formát:

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

Text odpovědi

Žádné

Další kroky