你当前正在访问 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

请求标头

下表介绍必需的和可选的请求标头。

请求标头 说明
授权 使用服务总线的共享访问签名身份验证或使用服务总线身份验证和 Microsoft Azure Active Directory 访问控制 (授权(也称为访问控制服务或 ACS) )中指定的方式生成的令牌。
Content-Type 设置为 application/json;charset=utf-8application/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

响应正文

无。

另请参阅