Partager via

Redirect Call - Redirect Call

Service:
Communication
Version d'API:
2026-03-12

Rediriger un appel.

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

Paramètres URI

Nom Dans Obligatoire Type Description
endpoint
 path True

string (url)

Le point de terminaison de la ressource Azure Communication Service.
api-version
 query True

string

Version de l’API à invoquer.

En-tête de la demande

Nom Obligatoire Type Description
Authorization True

string

Un jeton d’accès utilisateur Azure Communication Services.
Repeatability-Request-ID

string (uuid)

Si spécifié, le client indique que la demande est répétable ; c’est-à-dire que le client peut effectuer la requête plusieurs fois avec le mêmeRequest-Id de répétabilité et obtenir une réponse appropriée sans que le serveur n’exécute la demande plusieurs fois. La valeur de laRequest-Id Répétabilité est une chaîne opaque représentant un identificateur unique généré par le client pour la demande. Il s’agit d’un UUID de version 4 (aléatoire).
Repeatability-First-Sent

string (date-time-rfc1123)

Si l’en-tête Répétabilité-Request-ID est spécifié, l’en-tête Répétabilité-First-Sent doit également être spécifié. La valeur doit être la date et l’heure auxquelles la demande a été créée pour la première fois, exprimée à l’aide de la forme IMF-fixdate de HTTP-date. Exemple : Sun, 06 Nov 1994 08:49:37 GMT.

Corps de la demande

Nom Obligatoire Type Description
incomingCallContext True

string

Contexte associé à l’appel.
target True

CommunicationIdentifierModel

Réponses

Nom Type Description
204 No Content

Le service a redirigé l’appel vers le point de terminaison spécifié.
Other Status Codes

CommunicationErrorResponse

Error

Sécurité

Authorization

Un jeton d’accès utilisateur Azure Communication Services.

Type: apiKey
Dans: header

Exemples

RedirectCall

Exemple de requête

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

Exemple de réponse

Code d’état:
204

Définitions

RedirectCallRequest

Objet

Charge utile de la demande pour rediriger l’appel.

Nom Type Description
incomingCallContext

string

Contexte associé à l’appel.
target

CommunicationIdentifierModel