共用方式為

傳送 Microsoft 推播通知服務 (MPNS) 原生通知

  • 發行項

透過通知中樞傳送 MPNS 原生通知。

重要

Microsoft Push Notification Service (MPNS) 已被取代，不再支援。

要求

方法 要求 URI HTTP 版本
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 HTTP/1.1

要求標頭

下表描述必要的和選用的要求標頭。

要求標頭 描述
授權 使用 服務匯流排共用存取簽章驗證中所指定的 SAS 權杖。
Content-Type 設定為 application/xml;charset=utf-8。
ServiceBusNotification-Tags {single tag identifier} (選擇性)
ServiceBusNotification-Format 設定為 windowsphone
X-* 從 X 開始的所有標頭都會轉送到 MPNS。 請參閱Windows Phone 8 的推播通知。

要求本文

要求本文是 MPNS 所指定的XML 檔。 如果通知是 原始通知，本文為最多 1 Kb 的任何文字。 例如：

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

回應

回應包括 HTTP 狀態碼和一組回應標頭。

回應碼

程式碼 描述
200 已成功傳送訊息。
400 要求格式不正確， (例如，不正確路由標頭、不正確內容類型、訊息超過大小、不正確的訊息格式) 。
401 授權失敗。 存取金鑰不正確。
403 超過配額或訊息太大;訊息遭到拒絕。
404 URI 上沒有訊息分支。
413 要求的實體太大。 訊息大小不能超過 64 Kb。

如需狀態碼的相關資訊，請參閱 狀態和錯誤碼。

回應標頭

回應標頭 描述
位置 此標頭僅適用于標準層通知中樞。

此標頭將包含通知訊息識別碼。 它會與 取得通知訊息遙測 搭配使用，並讓 PNS 意見反應相互關聯。 位置標頭使用下列格式：

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

回應本文

無。

另請參閱