Call Connection - Get Call

Referens

Tjänst:: Communication

API-version:: 2024-09-15

Hämta informationsegenskaperna för ett pågående samtal.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
callConnectionId	path	True	string	Samtalsanslutnings-ID: t.
endpoint	path	True	string url	Slutpunkten för Azure Communication-resursen.
api-version	query	True	string	Version av API som ska anropas.

Begärandehuvud

Name	Obligatorisk	Typ	Description
Authorization	True	string	En användaråtkomsttoken för Azure Communication Services.

Svar

Name	Typ	Description
200 OK	CallConnectionProperties	Returnerar information om anropsegenskaperna.
Other Status Codes	CommunicationErrorResponse	Fel

Säkerhet

Authorization

En användaråtkomsttoken för Azure Communication Services.

Typ: apiKey
I: header

Exempel

CallConnection_GetCall

Exempelbegäran

HTTP

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

Exempelsvar

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

Definitioner

Name	Description
CallConnectionProperties	Egenskaper för en samtalsanslutning
CallConnectionStateModel	Tillståndet för samtalsanslutningen.

CallConnectionProperties

Egenskaper för en samtalsanslutning

Name	Typ	Description
answeredBy	CommunicationUserIdentifierModel
answeredFor	PhoneNumberIdentifierModel
callConnectionId	string	Samtalsanslutnings-ID: t.
callConnectionState	CallConnectionStateModel	Tillståndet för samtalsanslutningen.
callbackUri	string	Återanrops-URI:n.
correlationId	string	Korrelations-ID:t.
serverCallId	string	Serveranrops-ID.
source	CommunicationIdentifierModel
sourceCallerIdNumber	PhoneNumberIdentifierModel
sourceDisplayName	string	Visningsnamn för samtalet om du ringer upp till ett pstn-nummer.
targets	CommunicationIdentifierModel[]	Anropets mål.

CallConnectionStateModel

Tillståndet för samtalsanslutningen.

Name	Typ	Description
connected	string
connecting	string
disconnected	string
disconnecting	string
transferAccepted	string
transferring	string
unknown	string

Dela via