通过

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

响应正文

无。

另请参阅