共用方式為

Redirect Call - Redirect Call

服務:
Communication
API 版本:
2026-03-12

重新導向通話。

POST {endpoint}/calling/callConnections:redirect?api-version=2026-03-12

URI 參數

名稱 位於 必要 類型 Description
endpoint
 path True

string (url)

Azure 通訊服務資源的端點。
api-version
 query True

string

API 的 API 版本來調用。

要求標頭

名稱 必要 類型 Description
Authorization True

string

Azure 通訊服務使用者存取權杖。
Repeatability-Request-ID

string (uuid)

如果指定，用戶端會指示要求是可重複的;也就是說，用戶端可以使用相同的重複性Request-Id 多次提出請求，並取得適當的回應，而不需要伺服器多次執行請求。 重複性 -Request-Id 的值是不透明字串，代表用戶端針對要求產生的唯一識別碼。 它是版本 4（隨機）UUID。
Repeatability-First-Sent

string (date-time-rfc1123)

如果指定 Repeatability-Request-ID 標頭，則也必須指定 Repeatability-First-Sent 標頭。 值應該是第一次建立請求的日期和時間，使用 HTTP-date 的 IMF-fixdate 形式表示。 示例：1994 年 11 月 6 日星期日 08：49：37 GMT。

要求本文

名稱 必要 類型 Description
incomingCallContext True

string

與呼叫相關聯的內容。
target True

CommunicationIdentifierModel

回應

名稱 類型 Description
204 No Content

服務已將呼叫重新導向至指定的端點。
Other Status Codes

CommunicationErrorResponse

錯誤

安全性

Authorization

Azure 通訊服務使用者存取權杖。

類型: apiKey
位於: header

範例

RedirectCall

範例要求

POST https://contoso.communications.azure.com/calling/callConnections:redirect?api-version=2026-03-12

{
  "target": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_0f50d091-5bd3-448b-884d-44be7037d9b9"
    }
  },
  "incomingCallContext": "H4sIAAAAAAAEAMVVS2/bOBD+LzrspaElPiSSBoJFNnvYoNi0aHaBtpcFRQ5t1rIokLRTJ8h/X1J2soHRQ4A9lAdZ4ry+mflm/FhpNQy3PjnrtErOj9XysbLBb8uvM9WyEkul49J2ioEiGhlKADHVKiR7oVDXUGo5tkpa8k8zH9yglhuKuLQNkqLpEMZUNSZLNFfVRWVcnAZ1uFVbyP53EQLOtzCaybsx3ZSgnZFKKk4QgLGIybZFfU8oolIZzFrWGk6yzaDG1U6tYLaBMd9MKiSn3aROjjSRoAUHhG1PEDMdIGFlg4yRUmhChWQsm62dMdl+adUQ4aIKEP0u6KPft6RePV1Uyf/PmmmT5VijnlmMpD7VDLg4r9m4G4azgjWng37weD5nBTt6OS8YlcRyBhpJwD1iggFSbccQJVRJANW1gp4XLCc/uHETS/4qJaXX2dE6pSku61pNbgETMrBfxM1hgsUIqVzWe1Lrqda6iBBpmsXx9ZWW1vUe19aHDZja9pqBMRyBpQyxriVIgNBIGa11D9wy2tWE1Q7np6iPOH51lyXtLRinrsZ4D6FwQmdY28LEKfhV7nX8+XCfkZwAB/gGOv18WEccJ1A7M/0V1BgnHwq0/JmBYSoWEi84XTC+pIyLuszCXPBrPyYY0zPTsv57OBSOxJxoXjXzV3WzJs1D/+X22gy/36m762/vhk8PV5eXOWAm5gZKqDZ5/PCdc2L/vvmjbynGh3fhPus8lVIZFzLI7PBj8BNkOsPMRBc/nURXw+DvIbM7hR3MJnmWdNE6Itt7p2Gr3HAHKblxVcyfsp724x5CnPfizbh36WVDvpaUNIMfhplbb+1Xtp87hhfPr687lq/qB4HD9ec1vN98+OzhQ9Rfp26zKq34BS47ygVtBZdNS3AjMCnb0MU/d0NyH/NEH15WmYu/BZ+7q2L6b1oN9LvVS3se5z+B4w6lWIOSHOl5+rmiSJoOI9b0jZZATMPUD7bsm5ZGjrsKfjfNcb+faPH0LyoNW7KCBgAA"
}

範例回覆

狀態碼:
204

定義

RedirectCallRequest

Object

用於重新導向呼叫的要求承載。

名稱 類型 Description
incomingCallContext

string

與呼叫相關聯的內容。
target

CommunicationIdentifierModel