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

直接发送

将通知直接发送到设备句柄 (由通知类型) 表示的有效令牌。 此 API 的用户不需要使用注册或安装。 相反,此 API 的用户自行管理所有设备,仅使用 Azure 通知中心作为直通服务来与各种推送Notification Services通信。

注意

只要 Google 通过其 Firebase Cloud Messaging (FCM) 旧 API 支持 Google Cloud Messaging,我们将继续支持 Google Cloud Messaging (GCM) 。 此 API 尚不支持 Firebase Cloud Messaging (FCM) 。

请求

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

请求标头

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

请求标头 说明
授权 使用 服务总线 在共享访问签名身份验证中指定生成的令牌,或使用Microsoft Azure Active Directory 访问控制 ((也称为访问控制服务或 ACS) )服务总线身份验证和授权。
Content-Type 根据以下目标平台通知服务设置内容类型标头:
  • WNS:设置为 application/json;charset=utf-8 或 application/xml。 如果通知类型 (X-WNS-Type) 为“wns/raw”,则设为 application/octet-stream。
  • GCM和 APNS:设置为 application/json;charset=utf-8。
  • MPNS:设置为 application/xml;charset=utf-8。
ServiceBusNotification-DeviceHandle PNS 设备句柄。
ServiceBusNotification-Tags {单一标记标识符}(可选)
ServiceBusNotification-Format 设置为以下有效 PlatformType 值之一:windows、、applegcmwindowsphoneadm、、 nokiaxbaidu
x-ms-version 2015-04 (2015-01 及更高版本支持)

请求正文

根据平台类型,请求正文格式将更改。 请参阅本机发送 REST API 中每个平台的正文格式。

响应

响应包括 HTTP 状态代码和一组响应标头。 响应正文在成功时返回。

响应代码

代码 说明
201 已成功发送消息。
400 请求格式不正确(例如,路由标头无效、内容类型无效、消息大小超出限制、消息格式错误)。
401 授权失败。 访问密钥不正确。
403 已超出配额或消息太大;消息被拒绝。
404 URI 中没有消息分支。
413 请求的实体太大。 消息大小不能超过 64 Kb。

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

响应头

请注意,使用 HTTP 1.1 时,使用基于证书的身份验证时 ,PNS 反馈 不起作用;它不返回任何数据。 请使用基于令牌的身份验证。

响应标头 说明
Content-Type application/xml; charset=utf-8
位置 此标头仅适用于 标准层通知中心

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

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

响应正文

无。

另请参阅

直接批处理发送
发送 APNS 本机通知
发送GCM本机通知
发送 MPNS 本机通知
发送 WNS 本机通知