通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

(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。

有关状态代码的信息，请参阅 状态和错误代码。

响应头

响应标头 说明
位置 此标头仅适用于 标准层通知中心。

此标头将包含通知消息 ID。 它与 每个消息遥测 和关联 PNS 反馈一起使用。 位置标头使用以下格式：

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

响应正文

无。

另请参阅