查询数字资产详情
接口描述
- 本接口用于查询数字资产详细信息，只包含资产信息。
- 缩略图返回宽为60、140、360、850四个尺寸的等比缩放后的缩略图，业务可按需选用。
- 资产发行上链成功后，才会有链上交易的tx_id。
请求结构
POST /xasset/horae/v1/query HTTP/1.1
Host: xuper.baidu.com
Authorization: Authorization string
Content-Type: application/x-www-form-urlencoded;charset=utf-8
asset_id={asset_id}
请求头域
请求参数
| 参数名 |
参数类型 |
是否可选 |
参数说明 |
| asset_id |
int64 |
必选 |
要查询的资产id |
响应头域
响应参数
| 参数名 |
参数类型 |
参数说明 |
| errmsg |
string |
错误信息 |
| errno |
int |
错误码 详情参考错误码和状态码 |
| meta |
obejct |
资产信息 |
| +asset_id |
int64 |
资产id |
| +asset_cate |
int |
资产分类。1：艺术品 2：收藏品 3：门票 4：酒店 |
| +title |
string |
资产名称 |
| +thumb |
array |
资产图片 |
| ++urls |
array |
60、140、360、850四个尺寸的等比缩放后的缩略图链接 |
| ++width |
string |
图片的宽 |
| ++height |
string |
图片的高 |
| +short_desc |
string |
短文字描述 |
| +long_desc |
string |
长文字描述 |
| +img_desc |
array |
资产详情介绍长图 |
| +asset_url |
array |
资产原始文件，使用此地址可以查看资产的文件，如不能显示，请排查bos_v1 对应的字符串是否正确 |
| +amount |
int |
资产发行数量 |
| +price |
int64 |
资产显示价格，单位为分 |
| +status |
int |
1：初始 3：发行中 4：发行成功 5:冻结中 6:已冻结 7：封禁中 8:已封禁 |
| +asset_ext |
string |
资产额外描述信息json字符串。比如标签 |
| +group_id |
int64 |
资产组id。用于关联业务层酒店/店铺id |
| +tx_id |
string |
区块链资产发行交易Id，只有资产发行成功后该字段才不为空，可用于在区块链浏览器查看资产详情 |
请求示例
Post xasset/horae/v1/query
Host: xuper.baidu.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2022-04-18T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
asset_id=1332322111211
响应示例
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"
{
"errmsg": "succ",
"errno": 0,
"meta": {
"asset_id": 54579198857152999,
"asset_cate": 1,
"title": "猫的报恩",
"thumb": [
{
"urls": {
"icon": "https://xxx",
"url1": "https://xxx",
"url2": "https://xxx",
"url3": "https://xxx"
},
"width": "3000",
"height": "2000"
}
],
"short_desc": "猫咪的可爱，仅此一份",
"long_desc": "我是长描述",
"img_desc": [
"https://xxx"
],
"asset_ext": {"tags":["艺术品"]},
"amount": 1000,
"price": 10,
"status": 3,
"create_addr": "WcrGMFxxxYEtCmZp",
"tx_id": "23857a8dabxxxb630eaa56",
"group_id": 123123,
},
"request_id": "890537734354592704"
}
