Communication Identity - Exchange Teams User Access Token

Ссылка

Service:: Communication

API Version:: 2023-10-01

Обменяйте маркер доступа Azure Active Directory (Azure AD) пользователя Teams на новый маркер доступа удостоверения связи с соответствующим временем истечения срока действия.

POST {endpoint}/teamsUser/:exchangeAccessToken?api-version=2023-10-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string	Ресурс связи, например https://my-resource.communication.azure.com
api-version	query	True	string	Версия ВЫЗЫВАемого API.

Текст запроса

Имя	Обязательно	Тип	Описание
appId	True	string	Идентификатор клиента Azure AD приложения для проверки на соответствие утверждению appid в маркере доступа Azure AD.
token	True	string	Azure AD маркер доступа пользователя Teams, чтобы получить новый маркер доступа удостоверения связи.
userId	True	string	Идентификатор объекта пользователя Azure AD (пользователь Teams), проверяемого на соответствие утверждению oid в маркере доступа Azure AD.

Ответы

Имя	Тип	Описание
200 OK	CommunicationIdentityAccessToken	Успешное завершение
Other Status Codes	CommunicationErrorResponse	Ошибка

Примеры

Exchange a Teams user access token

Sample Request

HTTP

POST https://my-resource.communication.azure.com/teamsUser/:exchangeAccessToken?api-version=2023-10-01

{
  "token": "AzureActiveDirectoryAccessTokenOfATeamsUser",
  "appId": "2c3e1e83-8fd7-4615-ad2b-b8c1229845ac",
  "userId": "32c0a5db-05ec-78ea-51ab-3f06b329397e"
}

Sample Response

Status code:: 200

{
  "token": "CommunicationIdentityAccessToken",
  "expiresOn": "2023-10-10T21:39:39.3244584+00:00"
}

Определения

Имя	Описание
CommunicationError	Ошибка Служб коммуникации.
CommunicationErrorResponse	Ошибка Служб коммуникации.
CommunicationIdentityAccessToken	Маркер доступа.
TeamsUserExchangeTokenRequest

CommunicationError

Ошибка Служб коммуникации.

Имя	Тип	Описание
code	string	Код ошибки.
details	CommunicationError[]	Дополнительные сведения о конкретных ошибках, которые привели к этой ошибке.
innererror	CommunicationError	Внутренняя ошибка, если она есть.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

CommunicationErrorResponse