Megosztás a következőn keresztül:

Kötegek közvetlen küldése eszközleírók gyűjteményére

  • Cikk

Értesítések kötegét küldi közvetlenül az eszközleírók gyűjteményének (az Értesítés típusa által kifejezett érvényes jogkivonat). Ez az API alapszintű és standard szintű Notification Hub-névterekhez érhető el. Az API felhasználóinak nem kell regisztrációkat vagy telepítéseket használniuk. Ehelyett ennek az API-nak a felhasználói önállóan kezelik az összes eszközt, és csak átmenő szolgáltatásként használnak értesítési központot a különböző leküldéses értesítési szolgáltatásokkal való kommunikációhoz.

A Direct Batch Send jelenleg kérésenként legfeljebb 1000 eszközt támogat.

Megjegyzés

Továbbra is támogatjuk a Google Cloud Messaginget (GCM), amíg a Google támogatja azt a Firebase Cloud Messaging (FCM) örökölt API-n keresztül. Ez az API még nem támogatja a Firebase Cloud Messaging (FCM) szolgáltatást.

Kérés

Metódus Kérés URI-ja HTTP-verzió
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/$batch?direct&api-version=2015-08 HTTP/1.1

Kérésfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.

Kérelem fejléce Leírás
Engedélyezés A Service Bus közös hozzáférésű jogosultságkód-hitelesítésében megadottak szerint létrehozott SAS-jogkivonat. További információk: Általánosan használt fogalmak.
Content-Type multipart/mixed; boundary="boundary-string"

A határsztring az egyes részeket az RFC1341-ben meghatározott többrészes tartalomtípusnak megfelelően választja el egymástól. Minden rész egy beágyazási határral kezdődik, majd tartalmaz egy törzsrészt, amely fejlécterületből, üres sorból és törzsterületből áll.
ServiceBusNotification-Format Állítsa a következő érvényes PlatformType értékek egyikére: windows, apple, gcm, windowsphone, adm, , nokiax. baidu
x-ms-version 2015-04 (2015-01-ig és újabb verziókig támogatott)

A kérés törzse

A kérelemtörzs az RFC1341-ben meghatározott többrészes. Minden rész egy beágyazási határral kezdődik, majd tartalmaz egy törzsrészt, amely fejlécterületből, üres sorból és törzsterületből áll. Az üres hivatkozás nem tartalmazhat szóközt. Tekintse meg az alábbi példakéréseket.

A célplatform típusa alapján az értesítési rész törzsformátuma úgy módosul, hogy megfeleljen az egyes platformoknak az alábbi natív Send API-kban leírtak szerint.

A kérelem törzsének részét képező eszközöknek az értesítést fogadó eszközleírók JSON-tömbjének kell lenniük.

Példák kérésére

Íme egy WNS-példa :

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--

Íme egy GCM-példa :

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--

A következő egy APNS-példa :

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--

Reagálás

A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz. A rendszer nem ad vissza választörzset a sikerhez.

Válaszkódok

Code Description
201 Létrehozott.
400 Nem található a megadott többrészes tartalom egy része.
401 Engedélyezési hiba. A hozzáférési kulcs helytelen volt.
403 Kvóta túllépve vagy az üzenet túl nagy; üzenet el lett utasítva.
404 Nincs üzenetág az URI-nál.
413 A kért entitás túl nagy. Az üzenet mérete nem lehet 64 kb-nál nagyobb.

Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.

Válaszfejlécek

Válaszfejléc Description
Content-Type alkalmazás/xml; charset=utf-8
Hely Ez a fejléc csak a Standard szintű Notification Hubshoz érhető el.

Ez a fejléc tartalmazza az értesítési üzenet azonosítóját. Az üzenetre vonatkozó telemetria: Értesítési üzenet telemetriai adatainak lekérése és a PNS-visszajelzések korrelációja. A hely fejléce a következő formátumot használja:

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

Választörzs

None

Lásd még:

Közvetlen küldés
APNS natív értesítés küldése
Natív GCM-értesítés küldése
MPNS-natív értesítés küldése
Natív WNS-értesítés küldése