Freigeben über

Redirect Call - Redirect Call

Dienst:
Communication
API-Version:
2026-03-12

Leiten Sie einen Anruf um.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
endpoint
 path True

string (url)

Der Endpunkt der Azure Communication Service-Ressource.
api-version
 query True

string

Version der API, die aufgerufen werden soll.

Anforderungsheader

Name Erforderlich Typ Beschreibung
Authorization True

string

Ein Azure Communication Services-Benutzerzugriffstoken.
Repeatability-Request-ID

string (uuid)

Wenn angegeben, weist der Client an, dass die Anforderung wiederholbar ist. Das heißt, dass der Client die Anforderung mehrmals mit der gleichen WiederholbarkeitsRequest-Id stellen und eine entsprechende Antwort zurückerhalten kann, ohne dass der Server die Anforderung mehrmals ausführt. Der Wert des Repeatability-Request-Id ist eine undurchsichtige Zeichenfolge, die einen vom Client generierten eindeutigen Bezeichner für die Anforderung darstellt. Es handelt sich um eine (zufällige) UUID der Version 4.
Repeatability-First-Sent

string (date-time-rfc1123)

Wenn Repeatability-Request-ID Header angegeben ist, muss auch Repeatability-First-Sent Header angegeben werden. Der Wert sollte das Datum und die Uhrzeit sein, zu der die Anforderung zum ersten Mal erstellt wurde, ausgedrückt mit der IMF-fixdate-Form von HTTP-date. Beispiel: Sun, 06 Nov 1994 08:49:37 GMT.

Anforderungstext

Name Erforderlich Typ Beschreibung
incomingCallContext True

string

Der Kontext, der dem Aufruf zugeordnet ist.
target True

CommunicationIdentifierModel

Antworten

Name Typ Beschreibung
204 No Content

Der Dienst hat den Aufruf an den angegebenen Endpunkt umgeleitet.
Other Status Codes

CommunicationErrorResponse

Fehler

Sicherheit

Authorization

Ein Azure Communication Services-Benutzerzugriffstoken.

Typ: apiKey
In: header

Beispiele

RedirectCall

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
204

Definitionen

RedirectCallRequest

Objekt

Die Anforderungsnutzlast für die Umleitung des Anrufs.

Name Typ Beschreibung
incomingCallContext

string

Der Kontext, der dem Aufruf zugeordnet ist.
target

CommunicationIdentifierModel