转移资产碎片
更新时间：2022-11-03
转移资产碎片
接口描述
- 本接口用于由当前持有地址转移资产碎片到目标地址。
- 本接口是收费接口，调用消耗次数。
- 需要当前持有碎片账户私钥对 asset_id 和 nonce 签名。
- 该API提供存储变更能力，业务运营方注意合规使用
免责声明
您不得利用百度公司提供的产品或服务进行数字商品（数字藏品）的二次及多次转卖交易等违规炒作，不得有偿转让或假借转赠名义实施变相买卖活动，并坚决抵制任何形式投机炒作行为，一经发现，百度超级链将有权立刻单方面终止合作及服务，并要求您承担相应的损失。
请求结构
POST /xasset/damocles/v1/transfer HTTP/1.1
Host: xuper.baidu.com
Authorization: Authorization string
Content-Type: application/x-www-form-urlencoded;charset=utf-8
asset_id={asset_id}
&shard_id={shard_id}
&addr={address}
&sign={sign}
&pkey={pkey}
&nonce={nonce}
&to_userid={user_id}
&to_addr={to_addr}请求头域
- 除公共头域外，无其它特殊头域。
请求参数
| 参数名 | 参数类型 | 是否可选 | 参数说明 |
|---|---|---|---|
| asset_id | int64 | 必选 | 资产id |
| shard_id | int64 | 必选 | 资产碎片id |
| addr | string | 必选 | 资产碎片拥有者账户地址 |
| sign | string | 必选 | 资产碎片拥有者私钥签名 私钥签名内容：msg = Sprintf(“%d%d”, asset_id, nonce)。sign = XassetSignECDSA(account, msg) |
| pkey | string | 必选 | 资产碎片拥有者账户公钥 |
| nonce | int64 | 必选 | 随机数 |
| to_addr | string | 必选 | 资产接收者账户地址 |
| to_userid | int64 | 可选 | 资产接收者用户id，必要时请安全处理后设置 |
响应头域
- 除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| errno | int | 错误码 0为成功，其他可参考常用错误码 |
| request_id | int | 后端生成，用于问题反馈，建议业务日志纪录 |
请求示例
Post xasset/damocles/v1/transfer
Host: xuper.baidu.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2022-04-18T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
asset_id=1332322111211
&shard_id=10
&addr=bFKZMPVBtUPb1bdoXzWwKX1jaSy9omMjR
&pubKey={"Curvname":"P-256","X":99992390283545488142355111780630053962942114118238766864067722901319912547387,"Y":62636249704255210574823120529280656364753347818712821209439354501575504249596}
&sign=B014EDF86B6DEE29E167E9D9ED9C5832
&nonce=8856422235281354998
&to_userid=123
&to_addr=akdul2kjl54435jlk345响应示例
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",
}