生成用户钱包接口
1. 场景描述
实名注册：个人用户实名信息通过平台签名的方式提交到薄盒进行注册。
2. 场景交互图
注意：
1、注册时需要提交用户的二要素信息必须为真实有效信息，否则注册将失败。
2、用户在使用taskId获取时必须要与提供的secretId一致。
流程：
1. 调用开通钱包接口（平台签名）提交实名信息，返回用户任务Id。
2. 用户通过任务Id定时的方式再次调用接口获取钱包信息。此时钱包生成完成。
3. 相关接口
1）开通钱包
说明：根据企业/商户提供的用户信息创建钱包
接口：api/v1/user/register
请求方式：post
请求参数：
| 字段名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| merchantId | int64 | 是 | 商户id，由薄盒分配 |
| personName | string | 是 | 真实姓名 |
| string | 否 | 用户邮箱 | |
| mobile | string | 是 | 手机 |
| idCard | string | 是 | 证件号码 |
| cardType | int | 是 | 证件类型 1-身份证 2-护照 3-港澳通行证 4-台湾通行证 5-外国人永居身份证 6-港澳台居民居住证 7-其他 |
| signData | string | 是 | 签名：md5(personName_mobile_idCard_cardType_secretKey) |
响应参数：
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | int | 是 |
正确：200 错误：500 |
| msg | string | 是 |
正确：成功 错误：错误原因 |
| data | string | 是 | {"taskId":"任务编号"} |
2）查询接口
说明：任务Id查询钱包信息
接口：api/v1/user/query
例如：api/v1/user/query/12809
请求方式：get
请求参数：
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| taskId | string | 是 | 任务编号 |
响应参数：
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | int | 是 |
正确：200 错误：500 |
| msg | string | 是 |
正确：成功 错误：错误原因 |
| data | string json array-listData | 是 | address地址 |
listData说明
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| type | int | 是 |
1树图链 2至信链 |
| userId | int64 | 是 |
用户编号 |
| address | string | 是 | 地址 |
| status | int | 是 |
1绑定中 2已绑定 3绑定失败 4未发起过绑定（未查询到） |
3）查询接口
说明：手机号查询钱包信息
接口：api/v1/user/querybytel/{mobile}
例如：api/v1/user/querybytel/1500000000
请求方式：get
请求参数：
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| mobile | string | 是 | 手机号 |
响应参数：
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | int | 是 |
正确：200 错误：500 |
| msg | string | 是 |
正确：成功 错误：错误原因 |
| data | string json array-listData | 是 | address地址 |
listData说明
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| type | int | 是 |
1树图链 2至信链 |
| userId | int64 | 是 |
用户编号 |
| address | string | 是 | 地址 |
| status | int | 是 |
1绑定中 2已绑定 3绑定失败 4未发起过绑定（未查询到） |
4）用户拥有的数字商品查询接口
说明：任务Id查询数字商品销毁状态信息
接口：api/v1/user/product/list
请求方式：post
请求参数：
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| merchantId | Long | 是 | 商户id |
| content | String | 是 | 手机号或地址 |
| currentPage | Integer | 否 | 默认值1，当前页码 |
| merchantId | Integer | 否 | 默认值10，每页数量 |
响应参数：
| 字段名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| code | int | 是 |
正确：200 错误：500 |
| msg | string | 是 |
正确：成功 错误：错误原因 |
| data | string json dat-listData | 是 | 拥有的商品列表 |
data说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| totalCount | Integer | 总数量 |
| pageSize | Integer | 每页数量 |
| currPage | Integer | 当前页码 |
| list | json对象 | 资产数据 |
| opusId | Long | 资产id |
| opusAttrId | Long | 藏品id |
| nftId | String | nftId |
| contentFileUrl | String | 内容链接 |
| blockChainAddr | String | 交易地址 |
| blockChainContract | String | 合约地址 |
| lastTradeTime | String | 交易时间 |
| metaData | String | 扩展字段，自定义数据 |
3. 错误码
| 错误码 | 描述 |
|---|---|
| 150001 | 重复请求 |
| 150002 | 商户不存在 |
| 150003 | 当前用户已存在 |
| 150004 | 创建用户异常 |
| 150005 | 未找到用户 |