Call Connection - Get Call

Служба:

Communication

Версия API:

2025-05-15

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

GET {endpoint}/calling/callConnections/{callConnectionId}?api-version=2025-05-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=2025-05-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	Состояние подключения к вызову.
MediaStreamingContentType
MediaStreamingSubscription	Объект подписки потоковой передачи мультимедиа.
MediaStreamingSubscriptionState	Состояние подписки потоковой передачи мультимедиа.
TranscriptionResultType
TranscriptionSubscription	Объект подписки транскрибирования.
TranscriptionSubscriptionState	Состояние подписки транскрибирования.

CallConnectionProperties

Object

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

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

CallConnectionStateModel

Перечисление

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

Значение	Описание
unknown
connecting
connected
transferring
transferAccepted
disconnecting
disconnected

MediaStreamingContentType

Перечисление

Значение	Описание
audio

MediaStreamingSubscription

Object

Объект подписки потоковой передачи мультимедиа.

Имя	Тип	Описание
id	string	Идентификатор подписки.
state	MediaStreamingSubscriptionState	Состояние подписки потоковой передачи мультимедиа.
subscribedContentTypes	MediaStreamingContentType[]	Подписанные типы контента потоковой передачи мультимедиа.

MediaStreamingSubscriptionState

Перечисление

Состояние подписки потоковой передачи мультимедиа.

Значение	Описание
disabled
inactive
active

TranscriptionResultType

Перечисление

Значение	Описание
final
intermediate

TranscriptionSubscription

Object

Объект подписки транскрибирования.

Имя	Тип	Описание
id	string	Идентификатор подписки.
locale	string	Указывает языковой стандарт, используемый для транскрипции, например, en-CA или en-AU.
state	TranscriptionSubscriptionState	Состояние подписки транскрибирования.
subscribedResultTypes	TranscriptionResultType[]	Подписанные типы результатов транскрибирования.

TranscriptionSubscriptionState

Перечисление

Состояние подписки транскрибирования.

Значение	Описание
disabled
inactive
active