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

(APNS 发送 Apple 平台通知服务) 本机通知

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

请求

方法	请求 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`。
ServiceBusNotification-Tags	`{single tag identifier}`（可选）
ServiceBusNotification-Format	设置为 `apple`。
ServiceBusNotification-Apns-Expiry	Apns 于 W3C DTF 格式的 YYYY-MM-DDThh:mmTZD（例如，1997-07-16T19:20+01:00）到期。

请求正文是 Apple 指定的 XML 文档。例如：

    { 
        "aps" : { 
            "alert" : " This is my toast message for iOS!", 
        }, 
    }

响应包括 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`

无。