Employee Identity (EIAM)

Get User's Bound Social Account List API

API

Used to retrieve the social accounts already bound by a user. Returns a list of social accounts upon successful call, or failure information upon failed call.

# Request Description

Request URL https://{your_domain}/api/v2/sdk/social

Request Method GET

Content-Type application/json

# Request Header Parameters

Parameter Name Chinese Name Required Type Example
X-operating-sys-version Caller Operating System Version Yes String windows10.1.1
X-device-fingerprint Caller Device Fingerprint Yes String 156aysdna213sc50
X-device-ip Caller IP No String 192.168.1.2
X-agent User-Agent Information Yes String Mozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X) AppleWebKit/605.1.15(KHTML, like Gecko)
Mobile/15E148/HuaWei-AnyOffice/2.6.1802.0010/com.huawei.cloudlink.workplace
X-L For Internationalization Language Setting No String zh
X-client-id Application Authorization ID Yes String nTo1eRIub60vPb54WeE6aojPwYwImtl4
Authorization ID token returned by the user login API. Format: Bearer {id_token} Yes String Bearer eyJraWQiOiI1ZWZhN2ZmZDA2Z...

# Request Parameters

None

# Response Example

Success Example:
HTTP/1.1 200 OK
Content-Type: application/json
{
		"social": [
		    {
		        "id": "20210516130247432-C84E-E5EA8CFE7",
		        "userId": "20210515202200788-094F-074FB1341",
		        "socialType": "weixin",
		        "social_uid": "001GKgGa15HGZA0aOxIa1bFktp1GKgG4_social_uid",
		        "socialNickname": null,
		        "socialHeadImage": null,
		        "socialAccountDetails": null,
		        "createdAt": "2021-05-16 13:02:48.513",
		        "updatedAt": "2021-05-16 13:02:48.513"
		    }
		]
}
Error Example:
HTTP/1.1 400 Bad Request
HTTP/1.1 400 Bad Request
{
    "error_code": "SDK.COMMON.1007",
    "error_msg": "state_token parameter error"
}
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

# Return Parameters

Parameter Name Chinese Name Type Description
social Social Information Collection LIst Social Information Collection
id System ID String System ID automatically generated by IDaaS
userId User ID String User ID
socialType Social Type String Social Type
social_uid Social ID String Social ID (corresponds to third-party ID, e.g., WeChat: openId)
socialNickname Nickname String Nickname
socialHeadImage Avatar tring Avatar
socialAccountDetails Description String Description
createdAt Creation Time String Creation Time
updatedAt Modification Time String Modification Time