Call Connection - Get Call

Služba:

Communication

Verze rozhraní API:

2024-09-15

Získejte podrobné vlastnosti probíhajícího volání.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
callConnectionId	path	True	string	ID připojení volání.
endpoint	path	True	string url	Koncový bod prostředku komunikace Azure.
api-version	query	True	string	Verze rozhraní API k vyvolání

Hlavička požadavku

Name	Vyžadováno	Typ	Description
Authorization	True	string	Přístupový token služby Azure Communication Services.

Odpovědi

Name	Typ	Description
200 OK	CallConnectionProperties	Vrátí podrobnosti o vlastnostech volání.
Other Status Codes	CommunicationErrorResponse	Chyba

Zabezpečení

Authorization

Přístupový token služby Azure Communication Services.

Typ: apiKey
V: header

Příklady

CallConnection_GetCall

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

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

Definice

Name	Description
CallConnectionProperties	Vlastnosti připojení volání
CallConnectionStateModel	Stav připojení volání.

CallConnectionProperties

Vlastnosti připojení volání

Name	Typ	Description
answeredBy	CommunicationUserIdentifierModel
answeredFor	PhoneNumberIdentifierModel
callConnectionId	string	ID připojení volání.
callConnectionState	CallConnectionStateModel	Stav připojení volání.
callbackUri	string	Identifikátor URI zpětného volání.
correlationId	string	ID korelace.
serverCallId	string	ID volání serveru.
source	CommunicationIdentifierModel
sourceCallerIdNumber	PhoneNumberIdentifierModel
sourceDisplayName	string	Zobrazovaný název hovoru, pokud se vytočíte na číslo veřejné telefonní sítě.
targets	CommunicationIdentifierModel[]	Cíle volání.

CallConnectionStateModel

Stav připojení volání.

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