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

Microsoft Leküldéses értesítési szolgáltatás (MPNS) natív értesítésének küldése

  • Cikk

Natív MPNS-értesítést küld egy értesítési központon keresztül.

Fontos

A Microsoft Leküldéses értesítési szolgáltatás (MPNS) elavult, és már nem támogatott.

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/xml;charset=utf-8 értékre.
ServiceBusNotification-Tags {single tag identifier} (nem kötelező)
ServiceBusNotification-Format Beállítás: windowsphone
X-* Az X-től kezdődő összes fejlécet a rendszer az MPNS-nek továbbítja. Lásd: Leküldéses értesítések a Windows Phone-telefon 8-hoz.

A kérés törzse

A kérelem törzse az MPNS által megadott XML-dokumentum. Ha az értesítés nyers értesítés, a törzs bármilyen, legfeljebb 1 Kb-os szöveg. Például:

<?xml version="1.0" encoding="utf-8"?>
<wp:Notification xmlns:wp="WPNotification" Version="2.0">
  <wp:Tile Id="[Tile ID]" Template="IconicTile">
    <wp:SmallIconImage [Action="Clear"]>[small Tile size URI]</wp:SmallIconImage>
    <wp:IconImage Action="Clear">[medium/wide Tile size URI]</wp:IconImage>
    <wp:WideContent1 Action="Clear">[1st row of content]</wp:WideContent1>
    <wp:WideContent2 Action="Clear">[2nd row of content]</wp:WideContent2>
    <wp:WideContent3 Action="Clear">[3rd row of content]</wp:WideContent3>
    <wp:Count Action="Clear">[count]</wp:Count>
    <wp:Title Action="Clear">[title]</wp:Title>
    <wp:BackgroundColor Action="Clear">[hex ARGB format color]</wp:BackgroundColor>
  </wp:Tile>
</wp:Notification>

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. Az értesítési üzenetek telemetriai adatainak lekérése és a PNS-visszajelzések korrelációja esetén használatos. 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: