Teams Extension Token - Exchange

サービス:

Communication

API バージョン:

2025-03-02-preview

Teams 電話トークンを ACS ユーザー アクセス トークンと交換します。

POST {endpoint}/access/teamsExtension/:exchangeAccessToken?api-version=2025-03-02-preview

URI パラメーター

名前	/	必須	型	説明
endpoint	path	True	string (url)	通信リソース (例: https://my-resource.communication.azure.com
api-version	query	True	string	呼び出す API のバージョン。

応答

名前	型	説明
200 OK	CommunicationIdentityAccessTokenResult	成功
Other Status Codes	CommunicationErrorResponse	エラー

例

Exchange a Teams Phone token

要求のサンプル

HTTP

POST https://my-resource.communication.azure.com/access/teamsExtension/:exchangeAccessToken?api-version=2025-03-02-preview

{}

応答のサンプル

状態コード:

200

{
  "identity": {
    "id": "8:acs:2dee53b4-368b-45b4-ab52-8493fb117652_c70d068c-2f32-484d-9455-73070cd5aadd_b27b64b9-39d2-44a3-869d-67700b74e805"
  },
  "accessToken": {
    "token": "token",
    "expiresOn": "2025-04-10T21:39:39.3244584+00:00"
  }
}

定義

名前	説明
CommunicationError	Communication Services エラー。
CommunicationErrorResponse	Communication Services エラー。
CommunicationIdentity	通信 ID。
CommunicationIdentityAccessToken	アクセス トークン。
CommunicationIdentityAccessTokenResult	アクセス トークンを使用した通信 ID。
TeamsExtensionExchangeTokenRequest

CommunicationError

Object

Communication Services エラー。

名前	型	説明
code	string	エラー コード。
details	CommunicationError[]	このエラーの原因となった特定のエラーの詳細。
innererror	CommunicationError	内部エラーがある場合。
message	string	エラー メッセージ。
target	string	エラーターゲット。

CommunicationErrorResponse

Object

Communication Services エラー。

名前	型	説明
error	CommunicationError	Communication Services エラー。

CommunicationIdentity

Object

通信 ID。

名前	型	説明
customId	string	カスタム ID (ID に関連付けられている場合)。
id	string	ID の識別子。
lastTokenIssuedAt	string (date-time)	ID のトークンが最後に発行された時刻。

CommunicationIdentityAccessToken

Object

アクセス トークン。

名前	型	説明
expiresOn	string (date-time)	トークンの有効期限。
token	string	ID に対して発行されたアクセス トークン。

CommunicationIdentityAccessTokenResult

Object

アクセス トークンを使用した通信 ID。

名前	型	説明
accessToken	CommunicationIdentityAccessToken	アクセス トークン。
identity	CommunicationIdentity	通信 ID。

TeamsExtensionExchangeTokenRequest

Object