认证 (OAuth)接口列表用户信息端点

用户信息端点

GET/openapi/v1/oauth/userinfo

返回当前 access_token 对应的用户信息,遵循 OpenID Connect UserInfo 端点约定。

可用于在完成 OAuth 授权流程后,验证 token 所代表的用户身份和所属 Space。


请求参数

Authorization必填string
Bearer <access_token>

响应参数

sub选填string
用户在 Tencent eSign 的唯一 ID(Subject)。
space_id选填string
token 绑定的 Space(租户)ID。
app_id选填string
签发该 token 的应用 ID。
email选填string
用户邮箱地址。
scope选填string
该 token 授予的权限范围。

响应示例

{
  "sub": "SG_1234567890",
  "space_id": "SGSPxQk2mN8pR4vW1yH3jT5bZ6aE7cF0",
  "app_id": "APxQk2mN8pR4vW1yH3jT5bZ6aE7cF0ab",
  "email": "user@example.com",
  "scope": "envelope:create envelope:read"
}

错误码

错误码说明
invalid_tokenaccess_token 缺失或无效。