竹云IDaaS•开放平台
客户身份(CIAM)

社交账号登录后绑定手机号或邮箱接口

接口

用于社交账号绑定手机号或邮箱操作，绑定成功返回用户session_token，绑定失败返回失败信息。

# 请求说明

请求地址 https://{your_domain}/api/v2/sdk/social/bind

请求方式 POST

请求类型 application/json

# 请求Header头参数

参数名 中文名称 必须 类型 示例
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) AppleWebKit/605.1.15(KHTML, like Gecko)
Mobile/15E148/HuaWei-AnyOffice/2.6.1802.0010/com.huawei.cloudlink.workplace
X-L 用于国际化语言设置 否 String zh
X-client-id 应用授权ID 是 String nTo1eRIub60vPb54WeE6aojPwYwImtl4
X-state-token 临时令牌 是 String eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWJqZW1...

# 请求包体示例

1、使用手机号+短信验证码

{
    "mobile":"15201657321",
    "verify_code":"123456"
}
1
2
3
4

# 请求参数

参数名 中文名称 必须 类型 描述
mobile 手机号 是 String 接收验证码的手机号
verify_code 验证码 是 String 接收到的验证码
获取验证码请参考发送短信验证码接口 type=BIND_MOBILE_SMS

2、使用邮箱+邮件验证码

{
    "email":"zhangsan@qq.com",
    "verify_code":"123456"
}
1
2
3
4

# 请求参数

参数名 中文名称 必须 类型 描述
email 邮箱 是 String 接收验证码的邮箱
verify_code 验证码 是 String 接收到的验证码
获取验证码请参考发送邮件验证码接口 type=BIND_EMAIL_EMS

# 返回示例

成功示例：
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"
}
错误示例：
HTTP/1.1 400 Bad Request
{
    "error_code": "IDAAS.SDK.COMMON.1001",
    "error_msg": "Parameter X-client-id cannot be left blank."
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# 返回参数

参数名 中文名称 类型 描述
status 返回结果 String 该字段可能返回的值如下
SUCCESS 登录成功
ACCESS_DENIED 拒绝访问
expire session_token有效期 Number session_token有效期，有效期内可使用session_token获取ticket
session_token 用户session_token String 用户session_token，可使用该token调用IDaaS接口获取sso_ticket，sso_ticket可以换取用户信息
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.0015 IdToken cannot be empty 请检查输入的IdToken是否为空
IdToken不能为空
400 IDAAS.SDK.PARAM.0016 IdToken is invalid or expired 请重新获取IdToken后再试
IdToken无效或已过期
400 IDAAS.SDK.PARAM.0017 Social ID cannot be empty 请检查输入的社交ID是否为空
社交ID不能为空

社交账号注册并绑定手机号或邮箱接口