客户身份(CIAM)

获取用户已绑定的社交账号列表

用于获取用户已绑定的社交账号,调用成功则返回社交账号列表,调用失败则返回失败信息。

此接口为登录后的接口,需要在header中添加鉴权信息:Authorization

# 请求说明

GET https://{your_domain}/api/v2/sdk/social

# 请求头

参数名 中文名称 必须 类型 示例
X-operating-sys-version 调用方客户端操作系统版本 String windows10.1.1
X-device-fingerprint 调用方客户端设备指纹 String 156aysdna213sc50
X-device-ip 调用方客户端IP String 192.168.1.2
X-agent User-Agent信息 String Mozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X)
X-L 用于国际化语言设置 String zh
X-client-id 应用授权ID String nTo1eRIub60vPb54WeE6aojPwYwImtl4
Authorization 授权信息 String Bearer {id_token}
content-type 内容格式类型 String application/json

# 请求示例

# 请求参数

# 返回示例

成功示例:
HTTP/1.1 200 OK
Content-Type: application/json
{
  "social": [
    {
      "id": "20210111142024468-ADFB-B41D22CEV",
      "userId": "20210111142020284-114D-7DF343948",
      "socialType": "weixin",
      "socialUid": "odVLG0-NK05w0000g1BCAnbC4WdM",
      "socialChannelId": "oKfHI1BJdxUEFCAakTeoYIlC22lw",
      "socialNickname": "云云",
      "socialHeadImage": "https://thirdwx.qlogo.cn/mmopen/vi_32/pP0UibPF2OL0oJPw/132",
      "socialAccountDetails": null,
      "idpId": "20211109143455927-43EC-A3622E9F5",
      "createdAt": "2021-01-10 14:20:24.468",
      "updatedAt": "2021-01-10 14:20:24.468"
    }
  ]
}


错误示例:
HTTP/1.1 400 Bad Request
{
    "error_code": "IDAAS.SDK.PARAM.0016",
    "error_msg": "IdToken is invalid or expired"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# 返回参数

参数名 中文名称 类型 描述
social 社交信息集合 LIst 社交信息集合
id 系统ID String IDaaS自动生成的系统ID
userId 用户ID String 用户ID
socialType 社交类型 String 社交类型,微信:weixin
socialUid 社交ID String 对应第三方ID,微信:unionId
socialChannelId 社交渠道ID String 对应微信:openId,其它社交认证源与socialUid一致
socialNickname 昵称 String 昵称
socialHeadImage 头像 String 头像
socialAccountDetails 描述 String 描述
idpId 认证源ID String 认证源ID
createdAt 创建时间 String 创建时间
updatedAt 修改时间 String 修改时间

# 错误码

状态码 错误码 错误信息 处理措施
400 IDAAS.SDK.PARAM.0001 Device information is incomplete 请检查输入的设备信息是否完整
设备信息不完整
400 IDAAS.SDK.PARAM.0002 clientId cannot be empty 请检查输入的clientId是否为空
clientId不能为空
400 IDAAS.SDK.PARAM.0003 The app is not registered, please register the app first 请检查输入的clientId是否正确
应用未注册,请先注册应用
400 IDAAS.SDK.PARAM.0015 IdToken cannot be empty 请检查输入的IdToken是否为空
IdToken不能为空
400 IDAAS.SDK.PARAM.0016 IdToken is invalid or expired 请重新获取IdToken后再试
IdToken无效或已过期