Közvetlen küldés
Értesítést küld közvetlenül egy eszközkezelőnek (az Értesítés típusa által kifejezett érvényes jogkivonat). Az API felhasználóinak nem kell regisztrációkat vagy telepítéseket használniuk. Ehelyett minden eszközt önállóan kezel, és az Azure Notification Hubsot kizárólag átmenő szolgáltatásként használja a különböző leküldéses értesítési szolgáltatásokkal való kommunikációhoz.
Fontos
A Firebase Cloud Messaging (FCM) egy olyan szolgáltatás, amely többek között lehetővé teszi a fejlesztők számára, hogy leküldéses értesítéseket küldjenek a Google Play által támogatott Android-eszközökre. Az Azure Notification Hubs jelenleg az örökölt HTTP-protokoll használatával kommunikál az FCM-kel. Az FCM v1 egy frissített API, amely további funkciókat és képességeket kínál. A Google bejelentette, hogy elavult az FCM örökölt HTTP-jén, és 2024. június 20-án nem támogatja azt. Ezért azok a fejlesztők, akik az Azure Notification Hubs használatával kommunikálnak ma a Google Play által támogatott Android-eszközökkel, az alkalmazásaikat és az értesítési hasznos adataikat az újabb formátumba kell migrálniuk. Az Azure Notification Hubs továbbra is támogatja az FCM örökölt HTTP-t, amíg a Google nem fogadja el a kéréseket. Az új FCM-integráció befejezése után az Azure Notification Hubs bejelenti, hogy mikor kezdheti meg az áttelepítést. További részletekért tekintse meg az áttelepítés lépéseit ebben a cikkben.
Kérés
| Metódus | Kérés URI-ja | HTTP-verzió |
|---|---|---|
| POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 |
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 használatával történő közös hozzáférésű aláírás-hitelesítésben megadott módon létrehozott SAS-jogkivonat. |
| Content-Type | Állítsa be a Content-Type fejlécet a célplatform értesítési szolgáltatása alapján:
|
| ServiceBusNotification-DeviceHandle | A PNS-eszköz leírója. |
| ServiceBusNotification-Tags | {egycímke-azonosító} (nem kötelező) |
| ServiceBusNotification-Format | Állítsa a következő érvényes PlatformType értékek egyikére: windows, apple, gcm, windowsphone, , , nokiaxadmbaidu |
| x-ms-version | 2015-04 (2015-01-ig és újabb verziókig támogatott) |
A kérés törzse
A platform típusa alapján a kérelemtörzs formátuma megváltozik. Tekintse meg az egyes platformok törzsformátumát a natív Send REST API-kban.
- APNS-natív értesítés küldése
- Natív FCM-é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
Reagálás
A válasz tartalmaz egy HTTP-állapotkódot és egy válaszfejléceket. A válasz törzse sikeres lesz.
Válaszkódok
| Code | Description |
|---|---|
| 201 | Az üzenet elküldése sikerült. |
| 400 | A kérés helytelen (például nem érvényes útválasztási fejlécek, nem érvényes tartalomtípus, az üzenet mérete meghaladja a méretet, rossz üzenetformátum). |
| 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; az üzenet el lett utasítva. |
| 404 | Az URI-n nincs üzenetág. |
| 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
A HTTP 1.1 használatakor a PNS-visszajelzések nem működnek tanúsítványalapú hitelesítés használatakor; nem ad vissza adatokat. Jogkivonatalapú hitelesítés használata.
| Válaszfejléc | Description |
|---|---|
| Content-Type | application/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. Üzenetenkénti telemetriával használható: Értesítési üzenet telemetriai adatainak lekérése és a PNS-visszajelzések korrelálása. 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
Nincsenek.