Communication Identity - Exchange Teams User Access Token

Referencia

Servicio:: Communication

Versión de la API:: 2023-10-01

Intercambiar un token de acceso de Azure Active Directory (Azure AD) de un usuario de Teams para un nuevo token de acceso de Communication Identity con una fecha de expiración coincidente.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string	Recurso de comunicación, por ejemplo, https://my-resource.communication.azure.com
api-version	query	True	string	Versión de la API que se va a invocar.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
appId	True	string	Identificador de cliente de una aplicación de Azure AD que se va a comprobar con la notificación appid en el token de acceso de Azure AD.
token	True	string	Token de acceso de Azure AD de un usuario de Teams para adquirir un nuevo token de acceso de identidad de comunicación.
userId	True	string	Identificador de objeto de un usuario de Azure AD (usuario de Teams) que se va a comprobar con la notificación oid en el token de acceso de Azure AD.

Respuestas

Nombre	Tipo	Description
200 OK	CommunicationIdentityAccessToken	Éxito
Other Status Codes	CommunicationErrorResponse	Error

Ejemplos

Exchange a Teams user access token

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 200

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

Definiciones

Nombre	Description
CommunicationError	Error de Communication Services.
CommunicationErrorResponse	Error de Communication Services.
CommunicationIdentityAccessToken	Un token de acceso.
TeamsUserExchangeTokenRequest

CommunicationError

Error de Communication Services.

Nombre	Tipo	Description
code	string	Código de error.
details	CommunicationError[]	Más detalles sobre los errores específicos que llevaron a este error.
innererror	CommunicationError	Error interno si existe.
message	string	Mensaje de error.
target	string	Destino del error.

CommunicationErrorResponse