Skip to content

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

用户未绑定系统手机号或邮箱并用社交账号登录,认证源配置为绑定或注册时调用本接口。

请求说明

请求头

参数名中文名称必须类型描述
X-operating-sys-version调用方操作系统版本Stringwindows10.1.1
X-device-fingerprint调用方设备指纹String156aysdna213sc50
X-device-ip调用方IPString192.168.1.2
X-agentUser-Agent信息StringMozilla/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用于国际化语言设置Stringzh
X-client-id应用授权IDStringnTo1eRIub60vPb54WeE6aojPwYwImtl4
X-state-token临时令牌StringeyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdW...

请求示例

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

json
{
    "mobile":"15201657321",
    "verify_code":"123456"
}

请求参数

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

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

json
{
  "email":"zhangsan@qq.com",
  "verify_code":"123456"
}
参数名中文名称必须类型描述
email邮箱String接收验证码的邮箱
verify_code邮件验证码String接收到的验证码
获取验证码请参考发送邮件验证码接口
type = REGISTER_EMS

返回示例

成功示例

HTTP/1.1 200 OK

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

json
{
    "error_code": "SDK.COMMON.1007",
    "error_msg": "state_token 参数错误"
}

返回参数

参数名中文名称类型描述
status返回结果String该字段可能返回的值如下
SUCCESS 登录成功
expiresession_token有效期Numbersession_token有效期,有效期内可使用session_token获取ticket
session_token用户session_tokenString用户session_token,可使用该token调用IDaaS接口获取sso_ticket,sso_ticket可以换取用户信息
id_token短期有效,接口调用凭证String该字段是一个jwt,保存了用户信息以及应用的scope信息需要验签后获取,默认2小时有效,支持可配置

竹云IDaaS开放平台