数字商品流转

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 未找到用户