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

(MPNS) 本机通知发送 Microsoft 推送通知服务

通过通知中心发送 MPNS 本机通知。

重要

Microsoft 推送通知服务 (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。

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

响应头

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

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

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

响应正文

无。

另请参阅