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

功能介绍

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

URI

GET /api/v2/sdk/social

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
X-operating-sys-version	是	String	调用方操作系统版本，例如：Android 10。
X-device-fingerprint	是	String	调用方设备指纹，例如：156aysdna213sc50。
X-device-ip	否	String	调用方IP，例如：10.10.10.1。
X-agent	是	String	用户Agent信息，例如：Mozilla/5.0 (Linux; Android 10; Redmi K30 Build/QKQ1.190825.002; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/80.0.3987.99 Mobile Safari/537.36。
X-L	否	String	用于国际化语言设置，例如：zh。
X-client-id	是	String	应用标识，注册应用后分配的ClientId。
X-signature	是	String	加密数据为session_token=xxx&timestamp=xxx&nonce=xxx，其中：session_token为会话凭证，timestamp表示当前时间戳，nonce表示当前时间戳的16进制，加密方式为RSA公钥加密。当前时间戳可调用获取服务器时间接口获取，加密公钥可调用获取公钥接口获取。
X-tenant-id	否	String	租户id，ISV应用调用则为必填，需要将{domain_name}换成ISV通用域名{common_domain}，请求Header参数中需要指定对应租户的tenant_id，并将X-client-id换成ISV应用模板的client_id。

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
social	Array of SocialResult objects	社交账号信息集合。

表3 SocialResult
参数	参数类型	描述
id	String	系统自动生成的id。
userId	String	用户id。
socialType	String	社交类型。 weixin：微信。 weixinmp：微信公众平台。 weibo：微博。 qq：QQ。 alipay：支付宝。 wechat_work：企业微信。
social_uid	String	社交id。
socialNickname	String	昵称。
socialHeadImage	String	头像。
socialAccountDetails	String	描述。
createdAt	String	创建时间。
updatedAt	String	修改时间。

状态码：400

表4 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误详情。

请求示例

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

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

X-operating-sys-version: Android 10
X-device-fingerprint: 156aysdna213sac
X-device-ip: 10.10.10.1
X-agent: Mozilla/5.0 (Linux; Android 10; Redmi K30 Build/QKQ1.190825.002; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/80.0.3987.99 Mobile Safari/537.36
X-L: zh
X-client-id: DRrYIqauawN0I8myTMoDTPys6ezGZxnm
X-signature:D0JeOUuVqU8Ixvl0xrmewQRk4AuGZrtk1RfBxueNKUrNPpgSbXrYnzw...
X-tenant-id: 08f770f51f80d2f40f38c00cb199fd21

响应示例

状态码：200

请求成功。

{
  "social" : [ {
    "id" : "20210516130247432-C84E-E5EA8CFE7",
    "userId" : "20210515202200788-094F-074FB1341",
    "socialType" : "weixin",
    "social_uid" : "001GKgGa15HGZA0aOxIa1bFktp1GKgG4_social_uid",
    "socialNickname" : "zhangsan",
    "socialHeadImage" : "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTIQ8QOTSn3y4cYHLlMC3sv6RCBmeMkxtOog47Zr3v2Afbqc2bmP0WibUIUskX39eJlJAEbAibXs",
    "socialAccountDetails" : "zhangsan",
    "createdAt" : "2021-05-16 13:02:48.513",
    "updatedAt" : "2021-05-16 13:02:48.513"
  } ]
}