Social Account Registration and Binding Mobile/Email API

When a user has not bound a system mobile number or email and logs in with a social account, and the authentication source is configured to bind or register, call this API.

Request Description

Request Headers

Parameter Name	Name	Required	Type	Description
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	Used for internationalization language setting	No	String	zh
X-client-id	Application authorization ID	Yes	String	nTo1eRIub60vPb54WeE6aojPwYwImtl4
X-state-token	Temporary token	Yes	String	eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdW...

Request Example

1. Use mobile number + SMS verification code

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

Request Parameters

Parameter Name	Name	Required	Type	Description
mobile	Mobile number	Yes	String	Mobile number to receive the verification code
verify_code	SMS verification code	Yes	String	Received verification code To obtain the verification code, see Send SMS Verification Code API type = REGISTER_SMS

2. Use email + email verification code

{
  "email":"zhangsan@qq.com",
  "verify_code":"123456"
}

Parameter Name	Name	Required	Type	Description
email	Email	Yes	String	Email address to receive the verification code
verify_code	Email verification code	Yes	String	Received verification code To obtain the verification code, see Send Email Verification Code API type = REGISTER_EMS

Response Example

Success Example

HTTP/1.1 200 OK

{
    "session_token": "btsiBjx85prcZu6I6Ki057Tmw3nSF2VO",
    "expire": 604800,
    "status": "SUCCESS",
    "id_token": "eyJraWQiOiJrMSIsImFsZyI6IlJTMjU2In0.eyJpc3MiOiJJc3N1ZXIiLCJhdWQiOiJBdWRpZW5jZSIsImV4cCI6MTY1MzQ4NDQxMiwianRpIjoieUxSVGZXY1VkYk9PeUFpbHdZU0ZqZyIsImlhdCI6MTY1MzQ2NjQxMiwibmJmIjoxNjUzNDY2MjkyLCJzdWIiOiJzdWJqZWN0IiwiYXBpIjoie1wibmFtZVwiOlwiXCIsXCJtb2JpbGVcIjpcIis4Ni0xNTkwNzEzMjg1MlwiLFwiaWRcIjpcIjIwMjIwNDI1MTQwMTM4NTE5LUJGMUItNTI4QjA1NTFCXCIsXCJ1c2VyTmFtZVwiOlwibG91eGlcIixcImVtYWlsXCI6XCIxMUBxcS5jb21cIn0ifQ.al79knH1fKa4aT4AFr_FMjqBKu2pV_g-lKzzgHzmor5X-dHwSBUtjH38KOzjIqHvkcRMjXQuBnWmjRI7-0Djn2LuWVueaf3wRXLscCWiSDC7chjUyTRXMatYINxdvW-oSWFYGFqqbdsavLqOnvehd7ahEaTuiL9yZolvslZIkIxjxBJJu7A9Ln2sk3wf9pxXU83jIJ8ubPQBoVS-ilerTTJOKDZ9XsL2ftJsaqdTJK_mYbvKaVpLIVyHHJ2NcF6f-Al4N4kc8cgxtSgSKFDcR7Bz7dYlOcfUXCPAzJ3NZInm8UaksiWU02tvlvTRvRdoxZNnvD5vamZ5hjFc-cW5jA"
}

Error Example

HTTP/1.1 400 Bad Request

{
    "error_code": "SDK.COMMON.1007",
    "error_msg": "state_token parameter error"
}

Response Parameters

Parameter Name	Name	Type	Description
status	Return result	String	Possible values for this field SUCCESS Login successful
expire	session_token validity period	Number	Validity period of session_token; within this period, session_token can be used to obtain a ticket
session_token	User session_token	String	User session_token; this token can be used to call BambooCloud IDaaS APIs to obtain a sso_ticket, which can be exchanged for user information
id_token	Short-term valid interface call credential	String	This field is a JWT containing user information and the application's scope information; it must be verified and parsed. Default validity is 2 hours and is configurable