跳到主要内容

获取账号绑定的三方身份源

GET 
/auth/v1/user/provider

接口说明​

获取当前用户绑定的第三方身份源列表，包括已绑定的和可绑定的身份源信息

入参要求：​

  • Authorization: 当前登录用户的access_token（必填，请求头中传入，格式为Bearer xxx）
  • client_id: 应用对应的客户端id（可选，默认为环境id）
  • x-device-id: 设备id（可选，当前登录设备的id）

前置条件：​

  • 需要有效的access_token
  • 用户必须已登录

出参：​

  • 返回用户绑定的身份源列表（v1ProvidersResponse）
  • 包含身份源标识、名称、主页、头像、绑定状态等信息

获取绑定身份源请求示例​

GET /auth/v1/user/provider
Authorization: Bearer your_access_token
x-device-id: device_123456

获取绑定身份源响应示例​

{
  "total": 2,
  "data": [
    {
      "id": "github",
      "name": "GitHub",
      "homepage": "https://github.com",
      "picture": "https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png",
      "provider_user_name": "zhangsan",
      "provider_type": "oauth",
      "bind": true
    },
    {
      "id": "wechat",
      "name": "微信",
      "homepage": "https://open.weixin.qq.com",
      "picture": "https://res.wx.qq.com/a/wx_fed/assets/res/NTI4MWU5.ico",
      "provider_user_name": "",
      "provider_type": "oauth",
      "bind": false
    },
    {
      "id": "google",
      "name": "Google",
      "homepage": "https://accounts.google.com",
      "picture": "https://www.google.com/favicon.ico",
      "provider_user_name": "",
      "provider_type": "oauth",
      "bind": false
    }
  ]
}

使用场景：​

  • 用户查看已绑定的第三方登录方式
  • 用户选择可绑定的新身份源
  • 管理用户的多重身份验证方式
  • 展示用户登录方式的安全性状态

关键特性：​

  • 返回所有可用的身份源列表
  • 显示每个身份源的绑定状态
  • 包含身份源的基本信息和图标
  • 支持多种身份源类型（OAuth、OIDC、SAML等）

后续操作：​

  • 对于未绑定的身份源，可以调用绑定接口进行绑定
  • 对于已绑定的身份源，可以调用解绑接口进行解绑
  • 可以通过身份源信息进行登录方式切换

Request​

Responses​

A successful response.

Response Headers