数字商品流转
1. 场景描述
转移数字商品实现将数字藏品从一个地址转移到另一个地址，目前只支持同链的转移。转移接口只支持数字藏品发行方发行后，无偿转移到数字藏品申领者地址中。
转移接口适用于如下场景（满足以下任一条件可以发起转移）：
1. 销售：常用售卖给C端用户的数字商品的转移。
2. 空投：常用于企业平台直接赠与某人数字商品，常用于发行后免费赠送的场景。
3.兑换码：常用于企业平台希望间接赠与C端用户数字商品，C端用户通过兑换码在企业平台可直接兑换指定数字商品。
4. 转赠：需要数字藏品在转出地址持有180天及以上，可以调用此接口转移。
如果不满足以上任何一种场景，该接口会直接拒绝访问。
2. 场景交互图
流程：
1. 数字商品持有者发起转移请求，经由平台转发到薄盒开放平台。
2、用户在使用taskId获取时必须要与提供的secretId一致。
流程：
1. 调用开通钱包接口（平台签名）提交实名信息，返回用户任务Id。
2. 数字商品平台查询转移任务，成功后返回状态。
3. （非必要）数字藏品平台可以通过nftId查询数字藏品信息、数字藏品交易记录等信息。
3. 相关接口
1)数字商品 转移
说明：数字商品 转移，企业内外均只要在本saas平台已有的用户有都可以进行转移
接口：api/v1/order/create
请求方式：post
请求参数：
| 字段名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| merchantId | int64 | 是 | 商户id，由薄盒分配 |
| opusId | Long | 是 | 作品id |
| fromAddress | string | 否 | 转移从用户钱包地址，如果是销售该值是 ""。如果是转赠需要填写用户用户钱包，该值不能为null |
| toAddress | string | 是 | 转移到用户钱包地址 |
| opusAttrId | Long | 是 | 要转移的藏品id |
| signData | string | 是 | 签名：md5(merchantId_opusId_opusAttrId_fromAddress_toAddress_secretKey) |
响应参数：
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | int | 是 |
正确：200 错误：500 |
| msg | string | 是 |
正确：成功 错误：错误原因 |
| data | string | 是 | {"taskId":"任务编号"} |
2)数字商品转移状态查询
说明：任务Id查询数字商品转移状态信息
接口：api/v1/order/query
例如：api/v1/order/query/9527
请求方式：get
请求参数：
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| taskId | string | 是 | 任务编号 |
响应参数：
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | int | 是 |
正确：200 错误：500 |
| msg | string | 是 |
正确：成功 错误：错误原因 |
| data | string json json dat-listData | 是 | 数字藏品转移状态结果 |
data说明
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| chainType | int | 是 |
1树图链 |
| taskStatus | int | 是 |
1：待上链 2：上链成功 |
| taskMsg | string | 是 | 失败情况下会有提示信息 |
| txHash | string | 是 |
交易hash |
| chainTimestamp | int64 | 是 |
链上交易时间戳 |
3）销毁
说明：数字商品 销毁，企业内的用户数据进行销毁
接口：api/v1/order/destruction
请求方式：post
请求参数：
| 字段名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| merchantId | int64 | 是 | 商户id，由薄盒分配 |
| chainType | int | 是 | 上链类型：1 树图 2至信链 |
| address | string | 否 | 用户钱包地址 |
| nftId | string | 是 | 要销毁的nftId |
| signData | string | 是 | 签名：md5(chainType_userId_nftId_secretKey) |
响应参数：
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | int | 是 |
正确：200 错误：500 |
| msg | string | 是 |
正确：成功 错误：错误原因 |
| data | string | 是 | {"taskId":"任务编号"} |
4)数字商品销毁状态查询
说明：任务Id查询数字商品销毁状态信息
接口：api/v1/order/destructionQuery
例如：api/v1/order/destructionQuery/9527
请求方式：get
请求参数：
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| taskId | string | 是 | 任务编号 |
响应参数：
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | int | 是 |
正确：200 错误：500 |
| msg | string | 是 |
正确：成功 错误：错误原因 |
| data | string json json dat-listData | 是 | 数字藏品转移状态结果 |
data说明
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| taskStatus | int | 是 |
标记任务状态，任务执行中：2 任务成功：7 任务失败：10 |
| taskMsg | string | 是 | 失败情况下会有提示信息 |
| txHash | string | 是 |
交易hash |
| chainTimestamp | int64 | 是 |
链上交易时间戳 |
4. 错误码
| 错误码 | 描述 |
|---|---|
| 170001 | 转移失败 |
| 170020 | 未找到数据 |
| 170021 | 未配置树图链 |
| 170022 | 未找到用户 |