第三方应用自动绑定线上账户
更新时间:2022-08-12
第三方应用自动绑定链上账户
接口描述
- 本接口用于第三方账户使用passport union_id绑定其本地生成的区块链账户,绑定成功可在超级链钱包展示用户藏品。
- 第三方账户获取union_id见OAuth接入指南: https://openauth.baidu.com/doc/doc.html
- 由开发者服务的获取到union_id后,请求该api通过union_id和区块链账户助记词绑定链上账户。
- 同一个用户多次重复绑定,以首次绑定为准,不可换绑,重复绑定无效报错。
- 助记词通过xasset-sdk提供方法反解出完整链上账户。
- 开发者服务的AK/SK与区块链智能云的AK/SK不互通,需单独申请。
- 测试环境不可用,请线上回归,成功后即可在超级链钱包藏品列表页中展示区块链地址。
注意:
sk加解密使用 AES对称加密 PKCS7Padding 填充补齐 算法,客户方自行使用其 sk 做加密。xasset-sdk已经提供方法,客户方可直接使用不需要加解密。
请求结构
POST /xasset/did/v1/bindbyunionid HTTP/1.1
Host: xuper.baidu.com
Authorization: Authorization string
Content-Type: application/x-www-form-urlencoded;charset=utf-8
union_id={union_id}
&mnemonic={mnemonic}
请求头域
- 除公共头域外,无其它特殊头域。
请求参数
参数名 | 参数类型 | 是否可选 | 参数说明 |
---|---|---|---|
union_id | string | 必选 | 第三方应用获取的union_id sk加密串 |
mnemonic | string | 必选 | 待绑定区块链账户助记词 sk加密串 |
响应头域
- 除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
errno | int | 错误码 0为成功,其他可参考常用错误码 |
request_id | int | 后端生成,用于问题反馈,建议业务日志纪录 |
请求示例
POST /xasset/did/v1/bindbyunionid
Host: xuper.baidu.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2022-04-18T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
union_id=kjwfjiwqefjjfqwekljwqe
&mnemonic=hkjhsdkfhsalfhasfl
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 18 Apr 2022 03:28:11 GMT
X-Trace-Id: "1182282645"
{
"errno": 0,
"request_id": "1182282645",
}