你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Communication Identity - Issue Access Token

服务:

Communication

API 版本:

2023-10-01

为标识颁发新令牌。

POST {endpoint}/identities/{id}/:issueAccessToken?api-version=2023-10-01

URI 参数

名称	在	必需	类型	说明
endpoint	path	True	string	通信资源，例如 https://my-resource.communication.azure.com
id	path	True	string	要为其颁发令牌的标识的标识符。
api-version	query	True	string	要调用的 API 版本。

请求正文

名称	必需	类型	说明
scopes	True	CommunicationIdentityTokenScope[]	附加到令牌的范围的列表。
expiresInMinutes		integer	令牌的可选自定义有效期在 [60,1440] 分钟范围内。 如果未提供，将使用默认值 1440 分钟 (24 小时) 。

响应

名称	类型	说明
200 OK	CommunicationIdentityAccessToken	成功
Other Status Codes	CommunicationErrorResponse	错误

示例

Issue an access token. Optionally specify a custom expiration time within the [60-1440] minutes range. In case an expiration time is not specified, the default value of 1440 minutes (24 hours) will be used.

示例请求

HTTP

POST https://my-resource.communication.azure.com/identities/8:acs:2dee53b4-368b-45b4-ab52-8493fb117652_00000005-14a2-493b-8a72-5a3a0d000081/:issueAccessToken?api-version=2023-10-01

{
  "scopes": [
    "chat",
    "voip",
    "chat.join",
    "chat.join.limited",
    "voip.join"
  ],
  "expiresInMinutes": 60
}

示例响应

状态代码:

200

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

定义

名称	说明
CommunicationError	通信服务错误。
CommunicationErrorResponse	通信服务错误。
CommunicationIdentityAccessToken	访问令牌。
CommunicationIdentityAccessTokenRequest
CommunicationIdentityTokenScope	访问令牌的范围列表。

CommunicationError

通信服务错误。

名称	类型	说明
code	string	错误代码。
details	CommunicationError[]	有关导致此错误的特定错误的详细信息。
innererror	CommunicationError	内部错误（如果有）。
message	string	错误消息。
target	string	错误目标。

CommunicationErrorResponse

通信服务错误。

名称	类型	说明
error	CommunicationError	通信服务错误。

CommunicationIdentityAccessToken

访问令牌。

名称	类型	说明
expiresOn	string	令牌过期时间。
token	string	为标识颁发的访问令牌。

CommunicationIdentityAccessTokenRequest

名称	类型	默认值	说明
expiresInMinutes	integer	1440	令牌的可选自定义有效期在 [60,1440] 分钟范围内。 如果未提供，将使用默认值 1440 分钟 (24 小时) 。
scopes	CommunicationIdentityTokenScope[]		附加到令牌的范围的列表。

CommunicationIdentityTokenScope

访问令牌的范围列表。

名称	类型	说明
chat	string	使用它可以完全访问聊天 API。
chat.join	string	访问聊天 API，但未授权创建、删除或更新聊天线程。
chat.join.limited	string	更受限的 chat.join 版本，不允许添加或删除参与者。 当令牌持有者不完全受信任时（例如在来宾方案中），请使用此范围。
voip	string	使用它可完全访问呼叫 API。
voip.join	string	访问调用 API，但未经授权即可启动新调用。