Call Connection - Get Call

Service:

Communication

Version d'API:

2024-09-15

Obtenez les propriétés détaillées d’un appel en cours.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
callConnectionId	path	True	string	ID de connexion d’appel.
endpoint	path	True	string url	Point de terminaison de la ressource Azure Communication.
api-version	query	True	string	Version de l’API à appeler.

En-tête de la demande

Nom	Obligatoire	Type	Description
Authorization	True	string	Jeton d’accès utilisateur Azure Communication Services.

Réponses

Nom	Type	Description
200 OK	CallConnectionProperties	Retourne les détails des propriétés d’appel.
Other Status Codes	CommunicationErrorResponse	Erreur

Sécurité

Authorization

Jeton d’accès utilisateur Azure Communication Services.

Type: apiKey
Dans: header

Exemples

CallConnection_GetCall

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
CallConnectionProperties	Propriétés d’une connexion d’appel
CallConnectionStateModel	État de la connexion d’appel.

CallConnectionProperties

Propriétés d’une connexion d’appel

Nom	Type	Description
answeredBy	CommunicationUserIdentifierModel
answeredFor	PhoneNumberIdentifierModel
callConnectionId	string	ID de connexion d’appel.
callConnectionState	CallConnectionStateModel	État de la connexion d’appel.
callbackUri	string	URI de rappel.
correlationId	string	ID de corrélation.
serverCallId	string	ID d’appel du serveur.
source	CommunicationIdentifierModel
sourceCallerIdNumber	PhoneNumberIdentifierModel
sourceDisplayName	string	Nom complet de l’appel si vous composez un numéro rtc.
targets	CommunicationIdentifierModel[]	Cibles de l’appel.

CallConnectionStateModel

État de la connexion d’appel.

Nom	Type	Description
connected	string
connecting	string
disconnected	string
disconnecting	string
transferAccepted	string
transferring	string
unknown	string