Call Connection - Get Call

Tjänst:

Communication

API-version:

2025-05-15

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

GET {endpoint}/calling/callConnections/{callConnectionId}?api-version=2025-05-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=2025-05-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.
MediaStreamingContentType
MediaStreamingSubscription	Mediaströmningsprenumerationsobjekt.
MediaStreamingSubscriptionState	Prenumerationstillstånd för medieuppspelning.
TranscriptionResultType
TranscriptionSubscription	Transkriptionsprenumerationsobjekt.
TranscriptionSubscriptionState	Transkriptionsprenumerationstillstånd.

CallConnectionProperties

Objekt

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.
mediaStreamingSubscription	MediaStreamingSubscription	Tillståndet för medieströmningsprenumerationen för anropet
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.
transcriptionSubscription	TranscriptionSubscription	Transkriptionsprenumeration.

CallConnectionStateModel

Uppräkning

Tillståndet för samtalsanslutningen.

Värde	Description
connected
connecting
disconnected
disconnecting
transferAccepted
transferring
unknown

MediaStreamingContentType

Uppräkning

Värde	Description
audio

MediaStreamingSubscription

Objekt

Mediaströmningsprenumerationsobjekt.

Name	Typ	Description
id	string	Prenumerations-ID.
state	MediaStreamingSubscriptionState	Prenumerationstillstånd för medieuppspelning.
subscribedContentTypes	MediaStreamingContentType[]	Innehållstyper för medieströmning som prenumereras.

MediaStreamingSubscriptionState

Uppräkning

Prenumerationstillstånd för medieuppspelning.

Värde	Description
active
disabled
inactive

TranscriptionResultType

Uppräkning

Värde	Description
final
intermediate

TranscriptionSubscription

Objekt

Transkriptionsprenumerationsobjekt.

Name	Typ	Description
id	string	Prenumerations-ID.
locale	string	Anger det språk som används för transkription, t.ex. en-CA eller en-AU.
state	TranscriptionSubscriptionState	Transkriptionsprenumerationstillstånd.
subscribedResultTypes	TranscriptionResultType[]	Prenumererade transkriptionsresultattyper.

TranscriptionSubscriptionState

Uppräkning

Transkriptionsprenumerationstillstånd.

Värde	Description
active
disabled
inactive