客户身份(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
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无效或已过期 |