傳送範本通知
將通知傳送至通知中樞上的範本註冊。
要求
| 方法 | 要求 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 | 設定為 template (選擇性) |
要求本文
要求本文是 JSON 物件，只有字串屬性。 例如：
{
"message": "My message!",
"otherPropety": "my other value"
}
回應
回應包括 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 |
回應本文
無。