Server Calling - Redirect Call

Szolgáltatás:

Communication

API-verzió:

2022-04-07-preview

Hívás átirányítása.

POST {endpoint}/calling/callConnections:redirect?api-version=2022-04-07-preview

URI-paraméterek

Name	In	Kötelező	Típus	Description
endpoint	path	True	string (url)	Az Azure Communication-erőforrás végpontja.
api-version	query	True	string	A meghívandó API verziója.

Kérelem fejléce

Name	Kötelező	Típus	Description
Repeatability-Request-ID		string (uuid)	Ha meg van adva, az ügyfél azt irányítja, hogy a kérés megismételhető legyen; vagyis az ügyfél többször is végrehajthatja a kérést ugyanazzal az ismétlhetőséggel–Request-Id és a megfelelő választ kaphatja vissza anélkül, hogy a kiszolgáló többször hajtja végre a kérést. Az ismétlődésRequest-Id értéke egy átlátszatlan sztring, amely a kérelem ügyfél által létrehozott egyedi azonosítóját jelöli. Ez egy 4-es verziójú (véletlenszerű) UUID.
Repeatability-First-Sent		string	Ha az ismételhetőségRequest-ID fejléc van megadva, akkor az Ismételhetőség-First-Sent fejlécet is meg kell adni. Az értéknek a kérelem első létrehozásának dátuma és időpontja kell, hogy legyen, a HTTP-dátum IMF-fixdátum formájában kifejezve. Példa: V, 06 Nov 1994 08:49:37 GMT.

Kérelem törzse

Name	Kötelező	Típus	Description
incomingCallContext	True	string	A híváshoz társított környezet.
target	True	CommunicationIdentifierModel	A hívás átirányításának célidentitása.

Válaszok

Name	Típus	Description
204 No Content		Az átirányítási hívás válaszát adja vissza.
Other Status Codes	CommunicationErrorResponse	Hiba

Példák

Redirect a call.

Mintakérelem

HTTP

POST https://contoso.communications.azure.com/calling/callConnections:redirect?api-version=2022-04-07-preview

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

Mintaválasz

Állapotkód:

204

Definíciók

Name	Description
CommunicationCloudEnvironmentModel
CommunicationError
CommunicationErrorResponse	A Communication Services hibaválasza
CommunicationIdentifierModel
CommunicationIdentifierModelKind	A CommunicationIdentifierModel típusa.
CommunicationUserIdentifierModel
MicrosoftTeamsUserIdentifierModel
PhoneNumberIdentifierModel
RedirectCallRequest	A hívás átirányításának hasznos adatai.

CommunicationCloudEnvironmentModel

Enumerálás

Érték	Description
dod
gcch
public

CommunicationError

Objektum

Name	Típus	Description
code	string
details	CommunicationError[]
innererror	CommunicationError
message	string
target	string

CommunicationErrorResponse

Objektum

A Communication Services hibaválasza

Name	Típus	Description
error	CommunicationError

CommunicationIdentifierModel

Objektum

Name	Típus	Description
communicationUser	CommunicationUserIdentifierModel	A kommunikációs felhasználó.
kind	CommunicationIdentifierModelKind	A CommunicationIdentifierModel típusa.
microsoftTeamsUser	MicrosoftTeamsUserIdentifierModel	A Microsoft Teams-felhasználó.
phoneNumber	PhoneNumberIdentifierModel	A telefonszám.
rawId	string	Az azonosító teljes azonosítója.

CommunicationIdentifierModelKind

Enumerálás

A CommunicationIdentifierModel típusa.

Érték	Description
communicationUser
microsoftTeamsUser
phoneNumber
unknown

CommunicationUserIdentifierModel

Objektum

Name	Típus	Description
id	string

MicrosoftTeamsUserIdentifierModel

Objektum

Name	Típus	Description
cloud	CommunicationCloudEnvironmentModel
isAnonymous	boolean
userId	string

PhoneNumberIdentifierModel

Objektum

Name	Típus	Description
value	string

RedirectCallRequest

Objektum

A hívás átirányításának hasznos adatai.

Name	Típus	Description
incomingCallContext	string	A híváshoz társított környezet.
target	CommunicationIdentifierModel	A hívás átirányításának célidentitása.