Sdílet prostřednictvím

Odesílání dávek přímo do kolekce popisovačů zařízení

  • Článek

Odešle dávku oznámení přímo do kolekce popisovačů zařízení (platný token vyjádřený typem oznámení). Toto rozhraní API je k dispozici pro obory názvů Centra oznámení úrovně Basic a Standard. Uživatelé tohoto rozhraní API nemusí používat registrace ani instalace. Místo toho uživatelé tohoto rozhraní API spravují všechna zařízení sami a používají centrum oznámení výhradně jako předávací službu ke komunikaci s různými službami nabízených oznámení.

V tuto chvíli přímé dávkové odesílání podporuje až 1 000 zařízení na žádost.

Poznámka

I nadále podporujeme službu GCM (Google Cloud Messaging), dokud ji Google podporuje prostřednictvím starší verze rozhraní API služby Firebase Cloud Messaging (FCM). Toto rozhraní API zatím nepodporuje službu Firebase Cloud Messaging (FCM).

Žádost

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/$batch?direct&api-version=2015-08 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 vygenerovaný podle specifikace v části Ověřování pomocí sdíleného přístupového podpisu pomocí služby Service Bus. Další informace najdete v tématu Běžné koncepty.
Typ obsahu multipart/mixed; boundary="boundary-string"

Řetězec hranice se používá k oddělení jednotlivých částí podle vícedílného typu obsahu definovaného v DOKUMENTU RFC1341. Každá část začíná ohraničením zapouzdření a pak obsahuje část těla, která se skládá z oblasti záhlaví, prázdného řádku a oblasti textu.
ServiceBusNotification-Format Nastavte jednu z následujících platných hodnot PlatformType: windows, apple, gcm, windowsphone, adm, , nokiax. baidu
x-ms-version 4. roku 2015 (podporováno v 1. 1. 2015 a novějších)

Text požadavku

Text požadavku je vícedílný, jak je definováno v DOKUMENTU RFC1341. Každá část začíná ohraničením zapouzdření a pak obsahuje část těla, která se skládá z oblasti záhlaví, prázdného řádku a oblasti textu. Prázdný odkaz nesmí obsahovat žádné prázdné znaky. Podívejte se na příklady požadavků níže.

V závislosti na typu cílové platformy se formát textu části oznámení změní tak, aby vyhovoval jednotlivým platformám, jak je popsáno v níže uvedených nativních rozhraních API pro odesílání.

Zařízení, která je součástí textu požadavku, musí být pole JSON popisovačů zařízení, které obdrží oznámení.

Příklady požadavků

Tady je příklad služby WNS :

POST https://{namespace}.servicebus.windows.net/{Notification Hub}/messages/$batch?direct&api-version=2015-08 HTTP/1.1
Content-Type: multipart/mixed; boundary = "simple-boundary"
Authorization: SharedAccessSignature sr=https%3a%2f%2f{Namespace}.servicebus.windows.net%2f{Notification Hub}%2fmessages%2f%24batch%3fdirect%26api-version%3d2015-08&sig={Signature}&skn=DefaultFullSharedAccessSignature
ServiceBusNotification-Format: windows
X-WNS-Type: wns/toast
Host: {Namespace}.servicebus.windows.net
Content-Length: 514
Expect: 100-continue
Connection: Keep-Alive


--simple-boundary
Content-type: text/xml
Content-Disposition: inline; name=notification

<toast><visual><binding template="ToastText01"><text id="1">Hello there!</text></binding></visual></toast>
--simple-boundary
Content-type: application/json
Content-Disposition: inline; name=devices

['https://db5.notify.windows.com/?token={Token1}','https://db5.notify.windows.com/?token={Token2}','https://db5.notify.windows.com/?token={Token3}']
--simple-boundary--

Tady je příklad GCM :

POST https://{Namespace}.servicebus.windows.net/{Notification Hub}/messages/$batch?direct&api-version=2015-08 HTTP/1.1
Content-Type: multipart/mixed; boundary="simple-boundary"
Authorization: SharedAccessSignature sr=https%3a%2f%2f{Namespace}.servicebus.windows.net%2f{Notification Hub}%2fmessages%2f%24batch%3fdirect%26api-version%3d2015-08&sig={Signature}&skn=DefaultFullSharedAccessSignature
ServiceBusNotification-Format: gcm
Host: {Namespace}.servicebus.windows.net
Content-Length: 431
Expect: 100-continue
Connection: Keep-Alive


--simple-boundary
Content-Type: application/json
Content-Disposition: inline; name=notification

{"data":{"message":"Hello via Direct Batch Send!!!"}}
--simple-boundary
Content-Type: application/json
Content-Disposition: inline; name=devices

['Device Token1','Device Token2','Device Token3']
--simple-boundary--

Následuje příklad APNS :

POST https://{Namespace}.servicebus.windows.net/{Notification Hub}/messages/$batch?direct&api-version=2015-08 HTTP/1.1
Content-Type: multipart/mixed; boundary="simple-boundary"
Authorization: SharedAccessSignature sr=https%3a%2f%2f{Namespace}.servicebus.windows.net%2f{Notification Hub}%2fmessages%2f%24batch%3fdirect%26api-version%3d2015-08&sig={Signature}&skn=DefaultFullSharedAccessSignature
ServiceBusNotification-Format: apple
Host: {Namespace}.servicebus.windows.net
Content-Length: 511
Expect: 100-continue
Connection: Keep-Alive


--simple-boundary
Content-Type: application/json
Content-Disposition: inline; name=notification

{"aps":{"alert":"Hello using APNS via Direct Batch Send!!!"}}
--simple-boundary
Content-Type: application/json
Content-Disposition: inline; name=devices

['Device Token1','Device Token2','Device Token3']
--simple-boundary--

Odpověď

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

Kódy odpovědí

Kód Popis
201 Vytvořen.
400 Nelze najít část zadaného obsahu s více částmi.
401 Autorizace se nezdařila. 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

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

Toto záhlaví bude obsahovat ID zprávy oznámení. Používá se s telemetrií podle zpráv: Získání telemetrie oznámení a korelací 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é

Viz také

Přímé odeslání
Odeslání nativního oznámení APNS
Odeslání nativního oznámení GCM
Odeslání nativního oznámení MPNS
Odeslání nativního oznámení služby WNS