Call Connection - Get Call

서비스:

Communication

API 버전:

2024-09-15

진행 중인 호출의 세부 정보 속성을 가져옵니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
callConnectionId	path	True	string	호출 연결 ID입니다.
endpoint	path	True	string url	Azure Communication 리소스의 엔드포인트입니다.
api-version	query	True	string	호출할 API의 버전입니다.

요청 헤더

Name	필수	형식	Description
Authorization	True	string	Azure Communication Services 사용자 액세스 토큰입니다.

응답

Name	형식	Description
200 OK	CallConnectionProperties	호출 속성의 세부 정보를 반환합니다.
Other Status Codes	CommunicationErrorResponse	오류

보안

Authorization

Azure Communication Services 사용자 액세스 토큰입니다.

형식: apiKey
In(다음 안에): 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"
}

정의

Name	Description
CallConnectionProperties	호출 연결의 속성
CallConnectionStateModel	호출 연결의 상태입니다.

CallConnectionProperties

호출 연결의 속성

Name	형식	Description
answeredBy	CommunicationUserIdentifierModel
answeredFor	PhoneNumberIdentifierModel
callConnectionId	string	호출 연결 ID입니다.
callConnectionState	CallConnectionStateModel	호출 연결의 상태입니다.
callbackUri	string	콜백 URI입니다.
correlationId	string	상관 관계 ID입니다.
serverCallId	string	서버 호출 ID입니다.
source	CommunicationIdentifierModel
sourceCallerIdNumber	PhoneNumberIdentifierModel
sourceDisplayName	string	pstn 번호로 전화를 걸 때 통화의 이름을 표시합니다.
targets	CommunicationIdentifierModel[]	호출의 대상입니다.

CallConnectionStateModel

호출 연결의 상태입니다.

Name	형식	Description
connected	string
connecting	string
disconnected	string
disconnecting	string
transferAccepted	string
transferring	string
unknown	string