Call Connection - Get Call

Referencia

Servicio:: Communication

Versión de la API:: 2024-09-15

Obtenga las propiedades detalladas de una llamada en curso.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
callConnectionId	path	True	string	Identificador de conexión de llamada.
endpoint	path	True	string (url)	Punto de conexión del recurso de Comunicación de Azure.
api-version	query	True	string	Versión de la API que se va a invocar.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Authorization	True	string	Un token de acceso de usuario de Azure Communication Services.

Respuestas

Nombre	Tipo	Description
200 OK	CallConnectionProperties	Devuelve los detalles de las propiedades de la llamada.
Other Status Codes	CommunicationErrorResponse	Error

Seguridad

Authorization

Un token de acceso de usuario de Azure Communication Services.

Tipo: apiKey
En: header

Ejemplos

CallConnection_GetCall

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 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"
}

Definiciones

Nombre	Description
CallConnectionProperties	Propiedades de una conexión de llamada
CallConnectionStateModel	Estado de la conexión de llamada.

CallConnectionProperties

Object

Propiedades de una conexión de llamada

Nombre	Tipo	Description
answeredBy	CommunicationUserIdentifierModel
answeredFor	PhoneNumberIdentifierModel
callConnectionId	string	Identificador de conexión de llamada.
callConnectionState	CallConnectionStateModel	Estado de la conexión de llamada.
callbackUri	string	Identificador URI de devolución de llamada.
correlationId	string	Identificador de correlación.
serverCallId	string	Identificador de llamada del servidor.
source	CommunicationIdentifierModel
sourceCallerIdNumber	PhoneNumberIdentifierModel
sourceDisplayName	string	Nombre para mostrar de la llamada si se llama a un número rtc.
targets	CommunicationIdentifierModel[]	Destinos de la llamada.

CallConnectionStateModel

Enumeración

Estado de la conexión de llamada.

Valor	Description
connected
connecting
disconnected
disconnecting
transferAccepted
transferring
unknown

Compartir a través de