Communication Identity - Exchange Teams User Access Token

서비스:

Communication

API 버전:

2023-10-01

만료 시간이 일치하는 새 통신 ID 액세스 토큰에 대한 Teams 사용자의 Azure AD(Azure Active Directory) 액세스 토큰을 교환합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string	통신 리소스(예: https://my-resource.communication.azure.com
api-version	query	True	string	호출할 API의 버전입니다.

요청 본문

Name	필수	형식	Description
appId	True	string	Azure AD 액세스 토큰의 appid 클레임에 대해 확인할 Azure AD 애플리케이션의 클라이언트 ID입니다.
token	True	string	Teams 사용자의 액세스 토큰을 Azure AD 새 통신 ID 액세스 토큰을 획득합니다.
userId	True	string	Azure AD 액세스 토큰의 oid 클레임에 대해 확인할 Azure AD 사용자(Teams 사용자)의 개체 ID입니다.

응답

Name	형식	Description
200 OK	CommunicationIdentityAccessToken	Success
Other Status Codes	CommunicationErrorResponse	오류

예제

Exchange a Teams user access token

샘플 요청

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

샘플 응답

상태 코드:

200

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

정의

Name	Description
CommunicationError	Communication Services 오류입니다.
CommunicationErrorResponse	Communication Services 오류입니다.
CommunicationIdentityAccessToken	액세스 토큰입니다.
TeamsUserExchangeTokenRequest

CommunicationError

Communication Services 오류입니다.

Name	형식	Description
code	string	오류 코드입니다.
details	CommunicationError[]	이 오류로 이어진 특정 오류에 대한 자세한 내용입니다.
innererror	CommunicationError	내부 오류(있는 경우)입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

CommunicationErrorResponse

Communication Services 오류입니다.

Name	형식	Description
error	CommunicationError	Communication Services 오류입니다.

CommunicationIdentityAccessToken

액세스 토큰입니다.

Name	형식	Description
expiresOn	string	토큰의 만료 시간입니다.
token	string	ID에 대해 발급된 액세스 토큰입니다.

TeamsUserExchangeTokenRequest

Name	형식	Description
appId	string	Azure AD 액세스 토큰의 appid 클레임에 대해 확인할 Azure AD 애플리케이션의 클라이언트 ID입니다.
token	string	Teams 사용자의 액세스 토큰을 Azure AD 새 통신 ID 액세스 토큰을 획득합니다.
userId	string	Azure AD 액세스 토큰의 oid 클레임에 대해 확인할 Azure AD 사용자(Teams 사용자)의 개체 ID입니다.