客户身份(CIAM)
微博登录
微博登录接口调用过程中,根据配置返回不同结果。正常调用成功会返回用户的session_token,未绑定或开启二次认证会返回state_token,失败返回失败信息。
# 请求说明
POST https://{your_domain}/api/v2/sdk/login/weibo
# 请求头
参数名 | 中文名称 | 必须 | 类型 | 示例 |
---|---|---|---|---|
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 |
content-type | 内容格式类型 | 是 | String | application/json |
# 请求示例
{
"access_token":"8B11C37B7894C5E2347E1606DC7CCFDC",
"uid": "D8924F7071DC1D29A6822C794D848D9C"
}
1
2
3
4
2
3
4
# 请求参数
参数名 | 中文名称 | 必须 | 类型 | 描述 |
---|---|---|---|---|
access_token | 微博授权令牌 | 是 | String | 微博授权令牌 |
uid | 微博用户标识ID | 是 | String | 微博用户标识ID |
# 返回示例
成功示例1(成功匹配用户返回session_token):
HTTP/1.1 200 OK
Content-Type: application/json
{
"session_token": "btsiBjx85prcZu6I6Ki057Tmw3nSF2VO",
"expire": 604800,
"status": "SUCCESS",
"id_token": "eyJraWQiOiJrMSIsImFsZyI6IlJTMjU2In0.eyJpc3MiOiJJc3N1ZXIiLCJhdWQiOiJBdWRpZW5jZSIsImV4cCI6MTY1MzQ4NDQxMiwianRpIjoieUxSVGZXY1VkYk9PeUFpbHdZU0ZqZyIsImlhdCI6MTY1MzQ2NjQxMiwibmJmIjoxNjUzNDY2MjkyLCJzdWIiOiJzdWJqZWN0IiwiYXBpIjoie1wibmFtZVwiOlwiXCIsXCJtb2JpbGVcIjpcIis4Ni0xNTkwNzEzMjg1MlwiLFwiaWRcIjpcIjIwMjIwNDI1MTQwMTM4NTE5LUJGMUItNTI4QjA1NTFCXCIsXCJ1c2VyTmFtZVwiOlwibG91eGlcIixcImVtYWlsXCI6XCIxMUBxcS5jb21cIn0ifQ.al79knH1fKa4aT4AFr_FMjqBKu2pV_g-lKzzgHzmor5X-dHwSBUtjH38KOzjIqHvkcRMjXQuBnWmjRI7-0Djn2LuWVueaf3wRXLscCWiSDC7chjUyTRXMatYINxdvW-oSWFYGFqqbdsavLqOnvehd7ahEaTuiL9yZolvslZIkIxjxBJJu7A9Ln2sk3wf9pxXU83jIJ8ubPQBoVS-ilerTTJOKDZ9XsL2ftJsaqdTJK_mYbvKaVpLIVyHHJ2NcF6f-Al4N4kc8cgxtSgSKFDcR7Bz7dYlOcfUXCPAzJ3NZInm8UaksiWU02tvlvTRvRdoxZNnvD5vamZ5hjFc-cW5jA",
}
成功示例2(返回自动注册并绑定流程):
HTTP/1.1 200 OK
Content-Type: application/json
{
"state_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ7XCJzb2NpYWxVaWRcIjpcIm8zRHVFNVNySXVodTlIZHFucHd0c3Y5a2dkSFFcIixcInN0YXR1c1wiOlwiVVNFUl9SRUdJU1RFUlwifSIsImV4cCI6MTY0NjcwNTcwNCwiaWF0IjoxNjQ2NzAzOTA0LCJqdGkiOiIxNjQ2NzAzOTA0NTEwMCJ9.tLEpS-9jrXwiJI3GlZw4RGg_z0zMDzKMMZtPBv2VPS8",
"data": null,
"status": "USER_REGISTER"
}
成功示例3(返回绑定流程):
HTTP/1.1 200 OK
Content-Type: application/json
{
"state_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ7XCJzb2NpYWxVaWRcIjpcIm8zRHVFNVNySXVodTlIZHFucHd0c3Y5a2dkSFFcIixcInN0YXR1c1wiOlwiVVNFUl9SRUdJU1RFUlwifSIsImV4cCI6MTY0NjcwNTcwNCwiaWF0IjoxNjQ2NzAzOTA0LCJqdGkiOiIxNjQ2NzAzOTA0NTEwMCJ9.tLEpS-9jrXwiJI3GlZw4RGg_z0zMDzKMMZtPBv2VPS8",
"data": null,
"status": " SOCIAL_BIND"
}
成功示例4(返回二次认证流程):
HTTP 200 OK
{
"status": "MFA_AUTH",
"state_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ7XCJ1c2VySWRcIjpcIjIwMjIwMTIwMDk0MzEwNDM0LTg0N0MtQTFEOUJGOUIwXCIsXCJzdGF0dXNcIjpcIk1GQV9BVVRIXCJ9IiwiZXhwIjoxNjQ0MzkyNTEyLCJpYXQiOjE2NDQzOTA3MTIsImp0aSI6IjE2NDQzOTA3MTI2MDEwIn0.PcwlKPlPgIwnPZUE_s56_x5zB8YKaivfkpT0Fm5D2vU",
"data": "[\"SMS\"]"
}
成功示例5(返回拒绝登录流程):
HTTP 200 OK
{
"status": "ACCESS_DENIED",
"data": "拒绝访问"
}
错误示例:
HTTP/1.1 400 Bad Request
{
"error_code": "IDAAS.SDK.PARAM.0001",
"error_msg": "Device information is incomplete"
}
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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
# 返回参数
参数名 | 中文名称 | 类型 | 描述 |
---|---|---|---|
status | 登录流程状态标识 | String | 该字段可能返回的值如下: SUCCESS 登录成功 SOCIAL_BIND 绑定流程 USER_REGISTER 自动注册绑定流程 ACCESS_DENIED 拒绝访问 MFA_AUTH 登录程序但需要进行二次认证 |
expire | session_token有效期 | Number | session_token有效期,有效期内可使用session_token获取ticket |
session_token | 用户session_token | String | 用户session_token,可使用该token调用IDaas接口获取ticket,ticket可以换取用户信息 |
state_token | 用户带有状态的令牌 | String | 用户带有状态的令牌 |
data | 返回说明 | String | 返回说明 |
id_token | 短期有效,接口调用凭证 | String | 该字段是一个jwt,保存了用户信息以及应用的scope信息需要验签后获取,默认2小时有效,支持可配置 |
# 错误码
状态码 | 错误码 | 错误信息 | 处理措施 |
---|---|---|---|
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.0026 | Weibo access token cannot be empty | 请检查微博授权令牌是否为空 |
微博授权令牌不能为空 | |||
400 | IDAAS.SDK.PARAM.0027 | Weibo user ID cannot be empty | 请检查微博用户标识ID是否为空 |
微博用户标识ID不能为空 | |||
400 | IDAAS.SDK.USER.0001 | User not found | 请先注册后再试 |
用户未找到 | |||
400 | IDAAS.SDK.USER.0039 | User is disabled | 请联系管理员 |
用户已被禁用 | |||
500 | IDAAS.SDK.COM.0002 | System busy, please try again later | 请重新调用或联系竹云工作人员 |
系统繁忙,请稍后再试 |