Поделиться через

Communication Identity - Exchange Teams User Access Token

Служба:
Communication
Версия API:
2025-06-30

Обменяйте маркер доступа Entra ID пользователя Teams на новый маркер доступа Communication Identity с соответствующим сроком действия.

POST {endpoint}/teamsUser/:exchangeAccessToken?api-version=2025-06-30

Параметры URI

Имя В Обязательно Тип Описание
endpoint
 path True

string (url)

Ресурс связи, например https://my-resource.communication.azure.com
api-version
 query True

string

Версия API для вызова.

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

Имя Обязательно Тип Описание
appId True

string

Идентификатор клиента приложения Entra ID должен быть проверен на соответствие утверждению appid в маркере доступа Entra ID.
token True

string

Маркер доступа Entra ID пользователя Teams для получения нового маркера доступа Communication Identity.
userId True

string

Идентификатор объекта пользователя Entra ID (пользователя Teams) должен быть проверен на соответствие утверждению oid в маркере доступа Entra ID.

Ответы

Имя Тип Описание
200 OK

CommunicationIdentityAccessToken

Успех
Other Status Codes

CommunicationErrorResponse

Ошибка

Примеры

Exchange a Teams user access token

Образец запроса

POST https://my-resource.communication.azure.com/teamsUser/:exchangeAccessToken?api-version=2025-06-30

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

Пример ответа

Код состояния:
200 
{
  "token": "CommunicationIdentityAccessToken",
  "expiresOn": "2025-07-10T21:39:39.3244584+00:00"
}

Определения

Имя Описание
CommunicationError

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

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

Маркер доступа.
TeamsUserExchangeTokenRequest

Запрос на создание или обновление назначения Телефонной системы Teams.

CommunicationError

Object

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

Имя Тип Описание
code

string

Код ошибки.
details

CommunicationError[]

Дополнительные сведения об определенных ошибках, которые привели к этой ошибке.
innererror

CommunicationError

Внутренняя ошибка, если она есть.
message

string

Сообщение об ошибке.
target

string

Целевой объект ошибки.

CommunicationErrorResponse

Object

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

Имя Тип Описание
error

CommunicationError

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

CommunicationIdentityAccessToken

Object

Маркер доступа.

Имя Тип Описание
expiresOn

string (date-time)

Время истечения срока действия маркера.
token

string

Маркер доступа, выданный для удостоверения.

TeamsUserExchangeTokenRequest

Object

Запрос на создание или обновление назначения Телефонной системы Teams.

Имя Тип Описание
appId

string

Идентификатор клиента приложения Entra ID должен быть проверен на соответствие утверждению appid в маркере доступа Entra ID.
token

string

Маркер доступа Entra ID пользователя Teams для получения нового маркера доступа Communication Identity.
userId

string

Идентификатор объекта пользователя Entra ID (пользователя Teams) должен быть проверен на соответствие утверждению oid в маркере доступа Entra ID.