共用方式為

(WNS) 原生通知傳送 Windows 推播通知服務

  • 發行項

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

要求

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

要求標頭

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

要求標頭 描述
授權 使用 服務匯流排共用存取簽章驗證中所指定的 SAS 權杖。
Content-Type 設為 application/json;charset=utf-8 或 application/xml。 如果通知類型 (X-WNS-Type) 為 wns/raw ，請將 設定為 application/octet-stream 。
ServiceBusNotification-Tags {single tag identifier} (選擇性)
ServiceBusNotification-Format 設定為 windows
X-WNS- 從 X-WNS 開始的所有標頭都會轉送到 WNS。

要求本文

要求本文是 WNS 所指定的XML 檔。 如果通知的類型為 「wns/raw」，本文為最多 5 Kb 的任何文字。 例如：

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

回應

回應包括 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

回應本文

無。

另請參閱