Call Connection - Get Call

Служба:

Communication

Версия API:

2024-09-15

Получение подробных свойств текущего вызова.

GET {endpoint}/calling/callConnections/{callConnectionId}?api-version=2024-09-15

Параметры URI

Имя	В	Обязательно	Тип	Описание
callConnectionId	path	True	string	Идентификатор подключения вызова.
endpoint	path	True	string url	Конечная точка ресурса связи Azure.
api-version	query	True	string	Версия API для вызова.

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

Имя	Обязательно	Тип	Описание
Authorization	True	string	Маркер доступа пользователей служб коммуникации Azure.

Ответы

Имя	Тип	Описание
200 OK	CallConnectionProperties	Возвращает сведения о свойствах вызова.
Other Status Codes	CommunicationErrorResponse	Ошибка

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

Authorization

Маркер доступа пользователей служб коммуникации Azure.

Тип: apiKey
В: header

Примеры

CallConnection_GetCall

Образец запроса

HTTP

GET https://contoso.communications.azure.com/calling/callConnections/18dea47f-b081-4107-9a5c-4300819d2c6c?api-version=2024-09-15

Пример ответа

Код состояния:

200

{
  "callConnectionId": "18dea47f-b081-4107-9a5c-4300819d2c6c",
  "serverCallId": "aHR0cHM6Ly9jb252ZXJzYXRpb251cmwvdGVzdA",
  "sourceCallerIdNumber": {
    "value": "+18440123456"
  },
  "source": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_da7be3a9-8788-42a6-85c6-56b2cf784fce"
    }
  },
  "targets": [
    {
      "kind": "communicationUser",
      "communicationUser": {
        "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_0f50d091-5bd3-448b-884d-44be7037d9b9"
      }
    },
    {
      "kind": "phoneNumber",
      "phoneNumber": {
        "value": "+14250123456"
      }
    }
  ],
  "callConnectionState": "connected",
  "callbackUri": "https://app.contoso.com/callback"
}

Определения

Имя	Описание
CallConnectionProperties	Свойства подключения к вызову
CallConnectionStateModel	Состояние подключения к вызову.

CallConnectionProperties

Свойства подключения к вызову

Имя	Тип	Описание
answeredBy	CommunicationUserIdentifierModel
answeredFor	PhoneNumberIdentifierModel
callConnectionId	string	Идентификатор подключения вызова.
callConnectionState	CallConnectionStateModel	Состояние подключения к вызову.
callbackUri	string	Универсальный код ресурса (URI) обратного вызова.
correlationId	string	Идентификатор корреляции.
serverCallId	string	Идентификатор вызова сервера.
source	CommunicationIdentifierModel
sourceCallerIdNumber	PhoneNumberIdentifierModel
sourceDisplayName	string	Отображаемое имя звонка при вызове по номеру ТСОП.
targets	CommunicationIdentifierModel[]	Целевые объекты вызова.

CallConnectionStateModel

Состояние подключения к вызову.

Имя	Тип	Описание
connected	string
connecting	string
disconnected	string
disconnecting	string
transferAccepted	string
transferring	string
unknown	string