查询数字资产详情
更新时间：2022-06-28
查询数字资产详情
接口描述
- 本接口用于查询数字资产详细信息，只包含资产信息。
- 缩略图返回宽为60、140、360、850四个尺寸的等比缩放后的缩略图，业务可按需选用。
- 资产发行上链成功后，才会有链上交易的tx_id。
请求结构
JSON
1POST /xasset/horae/v1/query HTTP/1.1
2Host: xuper.baidu.com
3Authorization: Authorization string
4Content-Type: application/x-www-form-urlencoded;charset=utf-8
5
6asset_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，只有资产发行成功后该字段才不为空，可用于在区块链浏览器查看资产详情 |
请求示例
JSON
1Post xasset/horae/v1/query
2Host: xuper.baidu.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2022-04-18T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5asset_id=1332322111211响应示例
JSON
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 18 Apr 2022 03:28:11 GMT
4X-Trace-Id: "1182282645"
5 {
6 "errmsg": "succ",
7 "errno": 0,
8 "meta": {
9 "asset_id": 54579198857152999,
10 "asset_cate": 1,
11 "title": "猫的报恩",
12 "thumb": [
13 {
14 "urls": {
15 "icon": "https://xxx", // 60
16 "url1": "https://xxx", // 140
17 "url2": "https://xxx", // 360
18 "url3": "https://xxx" // 850
19 },
20 "width": "3000",
21 "height": "2000"
22 }
23 ],
24 "short_desc": "猫咪的可爱，仅此一份",
25 "long_desc": "我是长描述",
26 "img_desc": [
27 "https://xxx" // 原文件下载链接
28 ],
29 "asset_ext": {"tags":["艺术品"]},
30 "amount": 1000,
31 "price": 10,
32 "status": 3,
33 "create_addr": "WcrGMFxxxYEtCmZp",
34 "tx_id": "23857a8dabxxxb630eaa56",
35 "group_id": 123123,
36 },
37 "request_id": "890537734354592704"
38}