Az Apple Platform Notification Services (APNS) natív értesítésének küldése
Natív APNS-értesítést küld egy értesítési központon keresztül.
Kérés
Metódus | Kérés URI-ja | HTTP-verzió |
---|---|---|
POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 |
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 application/json;charset=utf-8 értékre. |
ServiceBusNotification-Tags |
{single tag identifier} (nem kötelező) |
ServiceBusNotification-Format | Állítsa apple értékre. |
ServiceBusNotification-Apns-Expiry | Az apnok lejárata W3C DTF, YYYY-MM-DDThh:mmTZD (például 1997-07-16T19:20+01:00). |
A kérés törzse
A kérelem törzse az Apple által megadott XML-dokumentum. Például:
{
"aps" : {
"alert" : " This is my toast message for iOS!",
},
}
Reagálás
A válasz tartalmaz egy HTTP-állapotkódot és egy válaszfejléceket.
Válaszkódok
Code | Description |
---|---|
200 | 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
Válaszfejléc | Description |
---|---|
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 telemetriai adatokkal 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.
Lásd még:
Közvetlen kötegelt küldés
APNS-natív értesítés küldése
MPNS-natív értesítés küldése
Natív WNS-értesítés küldéseSablonértesítés küldése