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_idint

OAuth 提供方 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"}。 解绑后该提供方无法再用于登录本账号,若这是账号唯一的登录方式,请确保已设置密码或其他登录方式,避免账号无法访问。