Поделиться через

Redirect Call - Redirect Call

Служба:
Communication
Версия API:
2026-03-12

Переадресация вызова.

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

Параметры URI

Имя В Обязательно Тип Описание
endpoint
 path True

string (url)

Конечная точка ресурса Azure Communication Service.
api-version
 query True

string

Версия API для вызова.

Заголовок запроса

Имя Обязательно Тип Описание
Authorization True

string

Маркер доступа пользователя Служб коммуникации Azure.
Repeatability-Request-ID

string (uuid)

Если указано, клиент указывает, что запрос является повторяемым; это означает, что клиент может сделать запрос несколько раз с одним и тем жеRequest-Id повторяемости и получить соответствующий ответ без повторного выполнения запроса сервером. ЗначениеRequest-Id Repeatability- представляет собой непрозрачную строку, представляющую уникальный идентификатор, созданный клиентом для запроса. Это версия 4 (случайная) UUID.
Repeatability-First-Sent

string (date-time-rfc1123)

Если указан заголовок Повторяемость-Request-ID, то также должен быть указан заголовок Повторяемость-First-Sent. Значением должна быть дата и время первого создания запроса, выраженные с помощью формы IMF-fixdate HTTP-date. Пример: Вс, 06 Ноя 1994 08:49:37 GMT.

Текст запроса

Имя Обязательно Тип Описание
incomingCallContext True

string

Контекст, связанный с вызовом.
target True

CommunicationIdentifierModel

Ответы

Имя Тип Описание
204 No Content

Сервис перенаправил вызов на указанную конечную точку.
Other Status Codes

CommunicationErrorResponse

Error

Безопасность

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

Объект

Полезная нагрузка запроса для переадресации вызова.

Имя Тип Описание
incomingCallContext

string

Контекст, связанный с вызовом.
target

CommunicationIdentifierModel