直接傳送
將通知直接傳送至裝置句柄， (以 通知 類型表示的有效令牌) 。 此 API 的使用者不需要使用註冊或安裝。 相反地，您可以自行管理所有裝置，並單獨使用 Azure 通知中樞作為傳遞服務，以與各種推播通知服務通訊。
重要
Firebase 雲端通訊 (FCM) 是一項服務，除此之外，可協助開發人員將推播通知傳送至 Google Play 支援的 Android 裝置。 Azure 通知中樞目前會使用舊版 HTTP 通訊協定與 FCM 通訊。 FCM v1 是更新的 API，可提供更多特色和功能。 Google 宣布他們即將淘汰 FCM 舊版 HTTP，並將於 2024 年 6 月 20 日停止支援它。 因此，目前使用 Azure 通知中樞與 Google Play 支援的 Android 裝置通訊的開發人員，必須將其應用程式和通知承載移轉至較新的格式。 Azure 通知中樞會繼續支援 FCM 舊版 HTTP，直到 Google 停止接受要求為止。 新的 FCM 整合完成後，Azure 通知中樞將會在開始移轉時宣佈。 如需詳細資訊，請參閱 本文中的移轉步驟。
要求
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 |
HTTP/1.1 |
要求標頭
下表描述必要的和選用的要求標頭。
| 要求標頭 | 描述 |
|---|---|
| 授權 | 使用 服務總線共用存取簽章驗證中所指定的SAS令牌。 |
| Content-Type | 根據目標平臺通知服務設定 Content-Type 標頭：
|
| ServiceBusNotification-DeviceHandle | PNS 裝置句柄。 |
| ServiceBusNotification-Tags | {單一標記標識符} (選擇性) |
| ServiceBusNotification-Format | 設定為下列其中一個有效的 PlatformType 值：windows、apple、、、gcm、admwindowsphone、 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 |
| 位置 | 此標頭僅適用於 標準層通知中樞。 此標頭包含通知訊息識別碼。 它會與個別訊息遙測搭配使用：取得通知訊息遙測，並讓 PNS 意見反應相互關聯。 位置標頭使用下列格式： https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04. |
回應本文
無。