Communication Identity - Exchange Teams User Access Token

Hizmet:

Communication

API Sürümü:

2023-10-01

Teams kullanıcısının Azure Active Directory (Azure AD) erişim belirtecini eşleşen bir süre sonu süresine sahip yeni bir İletişim Kimliği erişim belirteci için değiştirme.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string	İletişim kaynağı, örneğin https://my-resource.communication.azure.com
api-version	query	True	string	Çağrılacak API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
appId	True	string	Azure AD erişim belirtecindeki appid talebine göre doğrulanacak bir Azure AD uygulamasının istemci kimliği.
token	True	string	Yeni bir İletişim Kimliği erişim belirteci almak için Teams Kullanıcısının erişim belirtecini Azure AD.
userId	True	string	Azure AD erişim belirtecindeki oid talebine karşı doğrulanacak Azure AD kullanıcının (Teams Kullanıcısı) nesne kimliği.

Yanıtlar

Name	Tür	Description
200 OK	CommunicationIdentityAccessToken	Başarılı
Other Status Codes	CommunicationErrorResponse	Hata

Örnekler

Exchange a Teams user access token

Örnek isteği

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

Örnek yanıt

Durum kodu:

200

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

Tanımlar

Name	Description
CommunicationError	İletişim Hizmetleri hatası.
CommunicationErrorResponse	İletişim Hizmetleri hatası.
CommunicationIdentityAccessToken	Erişim belirteci.
TeamsUserExchangeTokenRequest

CommunicationError

İletişim Hizmetleri hatası.

Name	Tür	Description
code	string	Hata kodu.
details	CommunicationError[]	Bu hataya yol açan belirli hatalar hakkında daha fazla ayrıntı.
innererror	CommunicationError	Varsa iç hata.
message	string	Hata iletisi.
target	string	Hata hedefi.

CommunicationErrorResponse

İletişim Hizmetleri hatası.

Name	Tür	Description
error	CommunicationError	İletişim Hizmetleri hatası.

CommunicationIdentityAccessToken

Erişim belirteci.

Name	Tür	Description
expiresOn	string	Belirtecin süre sonu süresi.
token	string	Kimlik için verilen erişim belirteci.

TeamsUserExchangeTokenRequest

Name	Tür	Description
appId	string	Azure AD erişim belirtecindeki appid talebine göre doğrulanacak bir Azure AD uygulamasının istemci kimliği.
token	string	Yeni bir İletişim Kimliği erişim belirteci almak için Teams Kullanıcısının erişim belirtecini Azure AD.
userId	string	Azure AD erişim belirtecindeki oid talebine karşı doğrulanacak Azure AD kullanıcının (Teams Kullanıcısı) nesne kimliği.