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

Windows leküldéses értesítési szolgáltatás (WNS) natív értesítésének küldése

  • Cikk

Natív WNS-é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 a vagy application/xmla értékreapplication/json;charset=utf-8. Ha az értesítés típusa (X-WNS-Type) , wns/rawállítsa a következőre: application/octet-stream.
ServiceBusNotification-Tags {single tag identifier} (nem kötelező)
ServiceBusNotification-Format Beállítás: windows
X-WNS- Az X-WNS-től kezdődő összes fejlécet a rendszer WNS-nek továbbítja.

A kérés törzse

A kérelem törzse a WNS által megadott XML-dokumentum. Ha az értesítés típusa "wns/raw", akkor a törzs 5 Kb-ig bármilyen szöveg. Például:

<?xml version="1.0" encoding="utf-8" ?>
<toast>
    <visual lang="en-US">
        <binding template="ToastText01">
            <text id="1">
                This is my toast message for Win8!
            </text>
        </binding>
    </visual>
</toast>

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. Üzenetre vonatkozó telemetriai adatokkal és a PNS-visszajelzések korrelációjával használható. 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: