Sdílet prostřednictvím

Redirect Call - Redirect Call

Služba:
Communication
Verze rozhraní API:
2026-03-12

Přesměrovat hovor.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
endpoint
 path True

string (url)

Koncový bod zdroje Azure Communication Service.
api-version
 query True

string

Verze API pro vyvolání.

Hlavička požadavku

Name Vyžadováno Typ Description
Authorization True

string

Přístupový token uživatele Azure Communication Services.
Repeatability-Request-ID

string (uuid)

Pokud je tento parametr zadán, klient nařídí, že požadavek je opakovatelný. to znamená, že klient může požadavek provést vícekrát se stejnou opakovatelností –Request-Id a získat zpět příslušnou odpověď, aniž by server požadavek prováděl vícekrát. HodnotaRequest-Id opakovatelnosti je neprůhledný řetězec představující jedinečný identifikátor požadavku vygenerovaný klientem. Jedná se o UUID verze 4 (náhodné).
Repeatability-First-Sent

string (date-time-rfc1123)

Pokud je zadána hlavička Opakovatelnost-Request-ID, musí být zadána také hlavička Opakovatelnost-First-Sent. Hodnota by měla být datum a čas, kdy byl požadavek poprvé vytvořen, vyjádřený pomocí formuláře IMF-fixdate protokolu HTTP-date. Příklad: Sun, 06 Nov 1994 08:49:37 GMT.

Text požadavku

Name Vyžadováno Typ Description
incomingCallContext True

string

Kontext spojený s voláním.
target True

CommunicationIdentifierModel

Odpovědi

Name Typ Description
204 No Content

Služba přesměrovala volání na zadaný koncový bod.
Other Status Codes

CommunicationErrorResponse

Error

Zabezpečení

Authorization

Přístupový token uživatele Azure Communication Services.

Typ: apiKey
V: header

Příklady

RedirectCall

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
204

Definice

RedirectCallRequest

Objekt

Datová část požadavku pro přesměrování hovoru.

Name Typ Description
incomingCallContext

string

Kontext spojený s voláním.
target

CommunicationIdentifierModel