OAuth 绑定管理
查询本人已绑定的自定义 OAuth 第三方登录方式列表、解绑指定第三方登录。
OAuth 绑定管理接口均属于管理接口:鉴权方式为登录会话(或用户 access token)+ Jimu-Api-User 请求头,
不接受 sk- API 令牌本身,详见 鉴权与令牌。
错误响应为管理接口形态(success/message),见 错误处理与请求追踪。
本页覆盖的是站点管理员自行配置的自定义 OAuth 提供方(如企业内部 SSO、自建 OIDC)的绑定查询与解绑。 微信、Telegram、GitHub 等内置登录方式的绑定/解绑走各自专用接口,不在本页范围内。
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /api/user/self/oauth/bindings | 查询本人已绑定的自定义 OAuth 提供方列表 |
DELETE | /api/user/self/oauth/bindings/{provider_id} | 解绑指定的自定义 OAuth 提供方 |
查询绑定列表
GET
/api/user/self/oauth/bindings无需参数,返回本人当前绑定的全部自定义 OAuth 提供方。
响应200
{
"success": true,
"message": "",
"data": [
{
"provider_id": 2,
"provider_name": "公司 SSO",
"provider_slug": "company-sso",
"provider_user_id": "u_88213"
}
]
}
provider_idintOAuth 提供方 ID,用于解绑时定位
provider_namestring提供方展示名称
provider_slugstring提供方标识(slug)
provider_user_idstring该提供方体系内的用户标识(第三方系统的用户 ID)
未绑定任何自定义 OAuth 提供方时 data 为空数组。
解绑
DELETE
/api/user/self/oauth/bindings/{provider_id}provider_idint必填路径参数,要解绑的 OAuth 提供方 ID
响应200
{ "success": true, "message": "解绑成功" }
provider_id 不是合法整数时返回 {"success": false, "message": "无效的提供商 ID"}。
解绑后该提供方无法再用于登录本账号,若这是账号唯一的登录方式,请确保已设置密码或其他登录方式,避免账号无法访问。