共用方式為

Call Connection - Get Call

  • 參考
服務:
Communication
API 版本:
2024-09-15

取得進行中呼叫的詳細數據屬性。

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

URI 參數

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

string

呼叫連線標識碼。
endpoint
 path True

string

url

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

string

要叫用的 API 版本。

要求標頭

名稱 必要 類型 Description
Authorization True

string

Azure 通訊服務用戶存取令牌。

回應

名稱 類型 Description
200 OK

CallConnectionProperties

傳回呼叫屬性的詳細數據。
Other Status Codes

CommunicationErrorResponse

錯誤

安全性

Authorization

Azure 通訊服務用戶存取令牌。

類型: apiKey
位於: header

範例

CallConnection_GetCall

範例要求

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"
}

定義

名稱 Description
CallConnectionProperties

呼叫連線的屬性
CallConnectionStateModel

話叫連接的狀態。

CallConnectionProperties

呼叫連線的屬性

名稱 類型 Description
answeredBy

CommunicationUserIdentifierModel

answeredFor

PhoneNumberIdentifierModel

callConnectionId

string

呼叫連線標識碼。
callConnectionState

CallConnectionStateModel

話叫連接的狀態。
callbackUri

string

回呼 URI。
correlationId

string

相互關聯標識碼。
serverCallId

string

伺服器呼叫標識碼。
source

CommunicationIdentifierModel

sourceCallerIdNumber

PhoneNumberIdentifierModel

sourceDisplayName

string

如果撥出至 pstn 號碼，則顯示通話的名稱。
targets

CommunicationIdentifierModel[]

呼叫的目標。

CallConnectionStateModel

話叫連接的狀態。

名稱 類型 Description
connected

string

connecting

string

disconnected

string

disconnecting

string

transferAccepted

string

transferring

string

unknown

string