Udostępnij za pośrednictwem

Redirect Call - Redirect Call

Usługa:
Communication
Wersja interfejsu API:
2026-03-12

Przekieruj połączenie.

POST {endpoint}/calling/callConnections:redirect?api-version=2026-03-12

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
endpoint
 path True

string (url)

Punkt końcowy zasobu Azure Communication Service.
api-version
 query True

string

Wersja API do wywołania.

Nagłówek żądania

Nazwa Wymagane Typ Opis
Authorization True

string

Token dostępu użytkownika usług Azure Communication Services.
Repeatability-Request-ID

string (uuid)

Jeśli zostanie określony, klient poleca, że żądanie jest powtarzalne; oznacza to, że klient może wysłać żądanie wiele razy z tym samymRequest-Id powtarzalności i otrzymać odpowiednią odpowiedź bez wielokrotnego wykonywania żądania przez serwer. Wartość parametru Repeatability-Request-Id jest nieprzezroczystym ciągiem reprezentującym unikatowy identyfikator żądania wygenerowany przez klienta. Jest to UUID w wersji 4 (losowy).
Repeatability-First-Sent

string (date-time-rfc1123)

Jeśli określono nagłówek Powtarzalność-Request-ID, należy również określić nagłówek Powtarzalność-First-Sent. Wartość powinna być datą i godziną, w której żądanie zostało utworzone po raz pierwszy, wyrażoną przy użyciu formy IMF-fixdate HTTP-date. Przykład: Sun, 06 Nov 1994 08:49:37 GMT.

Treść żądania

Nazwa Wymagane Typ Opis
incomingCallContext True

string

Kontekst skojarzony z wywołaniem.
target True

CommunicationIdentifierModel

Odpowiedzi

Nazwa Typ Opis
204 No Content

Usługa przekierowała wywołanie do określonego punktu końcowego.
Other Status Codes

CommunicationErrorResponse

Błąd

Zabezpieczenia

Authorization

Token dostępu użytkownika usług Azure Communication Services.

Typ: apiKey
W: header

Przykłady

RedirectCall

Przykładowe żądanie

POST https://contoso.communications.azure.com/calling/callConnections:redirect?api-version=2026-03-12

{
  "target": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_0f50d091-5bd3-448b-884d-44be7037d9b9"
    }
  },
  "incomingCallContext": "H4sIAAAAAAAEAMVVS2/bOBD+LzrspaElPiSSBoJFNnvYoNi0aHaBtpcFRQ5t1rIokLRTJ8h/X1J2soHRQ4A9lAdZ4ry+mflm/FhpNQy3PjnrtErOj9XysbLBb8uvM9WyEkul49J2ioEiGhlKADHVKiR7oVDXUGo5tkpa8k8zH9yglhuKuLQNkqLpEMZUNSZLNFfVRWVcnAZ1uFVbyP53EQLOtzCaybsx3ZSgnZFKKk4QgLGIybZFfU8oolIZzFrWGk6yzaDG1U6tYLaBMd9MKiSn3aROjjSRoAUHhG1PEDMdIGFlg4yRUmhChWQsm62dMdl+adUQ4aIKEP0u6KPft6RePV1Uyf/PmmmT5VijnlmMpD7VDLg4r9m4G4azgjWng37weD5nBTt6OS8YlcRyBhpJwD1iggFSbccQJVRJANW1gp4XLCc/uHETS/4qJaXX2dE6pSku61pNbgETMrBfxM1hgsUIqVzWe1Lrqda6iBBpmsXx9ZWW1vUe19aHDZja9pqBMRyBpQyxriVIgNBIGa11D9wy2tWE1Q7np6iPOH51lyXtLRinrsZ4D6FwQmdY28LEKfhV7nX8+XCfkZwAB/gGOv18WEccJ1A7M/0V1BgnHwq0/JmBYSoWEi84XTC+pIyLuszCXPBrPyYY0zPTsv57OBSOxJxoXjXzV3WzJs1D/+X22gy/36m762/vhk8PV5eXOWAm5gZKqDZ5/PCdc2L/vvmjbynGh3fhPus8lVIZFzLI7PBj8BNkOsPMRBc/nURXw+DvIbM7hR3MJnmWdNE6Itt7p2Gr3HAHKblxVcyfsp724x5CnPfizbh36WVDvpaUNIMfhplbb+1Xtp87hhfPr687lq/qB4HD9ec1vN98+OzhQ9Rfp26zKq34BS47ygVtBZdNS3AjMCnb0MU/d0NyH/NEH15WmYu/BZ+7q2L6b1oN9LvVS3se5z+B4w6lWIOSHOl5+rmiSJoOI9b0jZZATMPUD7bsm5ZGjrsKfjfNcb+faPH0LyoNW7KCBgAA"
}

Przykładowa odpowiedź

Kod stanu:
204

Definicje

RedirectCallRequest

Objekt

Ładunek żądania służący do przekierowania połączenia.

Nazwa Typ Opis
incomingCallContext

string

Kontekst skojarzony z wywołaniem.
target

CommunicationIdentifierModel