Call Connection - Get Call

Servizio:

Communication

Versione API:

2025-05-15

Ottenere le proprietà dei dettagli di una chiamata in corso.

GET {endpoint}/calling/callConnections/{callConnectionId}?api-version=2025-05-15

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
callConnectionId	path	True	string	ID connessione di chiamata.
endpoint	path	True	string (url)	Endpoint della risorsa di comunicazione di Azure.
api-version	query	True	string	Versione dell'API da richiamare.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Authorization	True	string	Token di accesso utente di Servizi di comunicazione di Azure.

Risposte

Nome	Tipo	Descrizione
200 OK	CallConnectionProperties	Restituisce i dettagli delle proprietà della chiamata.
Other Status Codes	CommunicationErrorResponse	Errore

Sicurezza

Authorization

Token di accesso utente di Servizi di comunicazione di Azure.

Tipo: apiKey
In: header

Esempio

CallConnection_GetCall

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
CallConnectionProperties	Proprietà di una connessione di chiamata
CallConnectionStateModel	Stato della connessione di chiamata.
MediaStreamingContentType
MediaStreamingSubscription	Oggetto Sottoscrizione streaming multimediale.
MediaStreamingSubscriptionState	Stato della sottoscrizione di streaming multimediale.
TranscriptionResultType
TranscriptionSubscription	Oggetto Subscription di trascrizione.
TranscriptionSubscriptionState	Stato della sottoscrizione di trascrizione.

CallConnectionProperties

Object

Proprietà di una connessione di chiamata

Nome	Tipo	Descrizione
answeredBy	CommunicationUserIdentifierModel
answeredFor	PhoneNumberIdentifierModel
callConnectionId	string	ID connessione di chiamata.
callConnectionState	CallConnectionStateModel	Stato della connessione di chiamata.
callbackUri	string	URI di callback.
correlationId	string	L'ID di correlazione.
mediaStreamingSubscription	MediaStreamingSubscription	Stato della sottoscrizione di streaming multimediale per la chiamata
serverCallId	string	ID chiamata server.
source	CommunicationIdentifierModel
sourceCallerIdNumber	PhoneNumberIdentifierModel
sourceDisplayName	string	Nome visualizzato della chiamata se si effettua la chiamata a un numero pstn.
targets	CommunicationIdentifierModel[]	Destinazioni della chiamata.
transcriptionSubscription	TranscriptionSubscription	Sottoscrizione di trascrizione.

CallConnectionStateModel

Enumerazione

Stato della connessione di chiamata.

Valore	Descrizione
connected
connecting
disconnected
disconnecting
transferAccepted
transferring
unknown

MediaStreamingContentType

Enumerazione

Valore	Descrizione
audio

MediaStreamingSubscription

Object

Oggetto Sottoscrizione streaming multimediale.

Nome	Tipo	Descrizione
id	string	ID sottoscrizione.
state	MediaStreamingSubscriptionState	Stato della sottoscrizione di streaming multimediale.
subscribedContentTypes	MediaStreamingContentType[]	Tipi di contenuto di streaming multimediale sottoscritti.

MediaStreamingSubscriptionState

Enumerazione

Stato della sottoscrizione di streaming multimediale.

Valore	Descrizione
active
disabled
inactive

TranscriptionResultType

Enumerazione

Valore	Descrizione
final
intermediate

TranscriptionSubscription

Object

Oggetto Subscription di trascrizione.

Nome	Tipo	Descrizione
id	string	ID sottoscrizione.
locale	string	Specifica le impostazioni locali utilizzate per la trascrizione, ad esempio en-CA o en-AU.
state	TranscriptionSubscriptionState	Stato della sottoscrizione di trascrizione.
subscribedResultTypes	TranscriptionResultType[]	Tipi di risultati di trascrizione sottoscritti.

TranscriptionSubscriptionState

Enumerazione

Stato della sottoscrizione di trascrizione.

Valore	Descrizione
active
disabled
inactive