接口描述
获取当前调用方的用户级 access_token，用于连接数据面（ACP 对话）。
POST /v2/enterprises/{enterpriseId}/managedagent/user-access-token输入参数
路径参数
参数 | 类型 | 说明 |
enterpriseId | string | WorkBuddy 企业 ID |
查询参数
无
请求体
无（该接口无业务入参）
输出参数
（
201，业务出参包装在 code / data / msg / requestId 中）DescribeUserAccessTokenResponse 查询用户级 access_token 响应体。
字段 | 类型 | 说明 |
accessToken | string | AccessToken 用户级访问凭证。来源随入口不同： 云下 REST：APISIX openid-connect 透传的用户本人 access token（原样下发）； 云上 CAPI：login 颁发的 WorkBuddy 凭证（由 OneID t-token 换得）。 |
tokenType | string | TokenType 凭证类型，目前固定 Bearer。 |
expiresIn | integer | ExpiresIn 凭证有效期，单位：秒。云下透传场景取自 token 的 exp claim，解析不出来时为 0。 |
scope | string | Scope 凭证可访问用户信息的范围。 |
示例
输入示例
POST /v2/enterprises/{enterpriseId}/managedagent/user-access-tokenAuthorization: Bearer pt_<YOUR_APP_KEY>
输出示例
{"code": 0,"data": {"accessToken": "<REDACTED>","expiresIn": 3600,"scope": "string","tokenType": "<REDACTED>"},"msg": "OK","requestId": "3c6d138e-1234-5678-9abc-def012345678"}
错误码
说明：
错误码 | 说明 |
AuthFailure.UserAccessTokenMissing | 网关请求头中缺少用户级 access token |
FailedOperation.EntitlementNotFound | 未查询到服务开通记录，请先开通服务 |
FailedOperation.OneidAccountIdMissing | 权益记录缺少 OneID 账号 ID |
InternalError.UserAccessTokenExchangeFailed | 通过 OneID 换取用户级 access token 失败 |
InternalError.UserAccessTokenNotConfigured | 未配置用户级 access token 的 OneID 换取器 |
MissingParameter.SubAccountUinRequired | 公共参数中缺少 SubAccountUin |
MissingParameter.UinRequired | 公共参数中缺少 Uin |
