(APNS) 原生通知傳送 Apple Platform Notification Services
透過通知中樞傳送 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 | 例如,1997-07-16T19:20+01:00) ,W3C DTF、YYYY-MM-DDThh:mmTZD (的 Apns 到期。 |
要求本文
要求本文是 Apple 所指定的XML 檔。 例如:
{
"aps" : {
"alert" : " This is my toast message for iOS!",
},
}
回應
回應包括 HTTP 狀態碼和一組回應標頭。
回應碼
程式碼 | 描述 |
---|---|
200 | 已成功傳送訊息。 |
400 | 要求格式不正確 (例如,不正確路由標頭、不正確內容類型、訊息超過大小、不正確的訊息格式) 。 |
401 | 授權失敗。 存取金鑰不正確。 |
403 | 超過配額或訊息太大;訊息遭到拒絕。 |
404 | URI 沒有訊息分支。 |
413 | 要求的實體太大。 訊息大小不能超過 64 Kb。 |
如需狀態碼的相關資訊,請參閱 狀態和錯誤碼。
回應標頭
回應標頭 | 描述 |
---|---|
位置 | 此標頭僅適用于標準層通知中樞。 此標頭將包含通知訊息識別碼。 它與每個訊息遙測搭配使用:取得通知訊息遙測,並讓 PNS 意見反應相互關聯。 位置標頭使用下列格式: https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04 |
回應本文
無。