修改未发行的数字资产
更新时间：2022-09-09
修改未发行的数字资产
接口描述
- 本接口用于修改未发行的数字资产，已发行上链的数字资产不允许修改。
- 本接口需要账户私钥对 asset_id 和 nonce 签名授权。
- 使用本接口时asset_info、amount、price中要求至少有一个待更新。
-
如需修改藏品源文件注意上传文件格式要求：
-
图片格式支持：”jpg”, “png”, “gif”。 推荐使用jpg和png格式 -
音频文件支持：“mp3” 藏品封面图会作为音频播放站位图 -
视频文件支持：“mp4” -
3D模型支持：gltf，DAE gltf在使用时由于藏品为单文件，暂不支持上传文件夹；需要将材质烘焙到模型上 -
透明视频支持：afx 需要使用.afx.mp4后缀 -
其他的格式文件暂不支持
-
请求结构
POST /xasset/horae/v1/alter HTTP/1.1
Host: xuper.baidu.com
Authorization: Authorization string
Content-Type: application/x-www-form-urlencoded;charset=utf-8
asset_id={asset_id}
&amount={amount}
&price={price}
&asset_info={asset_info}
&addr={address}
&sign={sign}
&pkey={pkey}
&nonce={nonce}请求头域
- 除公共头域外，无其它特殊头域。
请求参数
| 参数名 | 参数类型 | 是否可选 | 参数说明 |
|---|---|---|---|
| asset_id | int64 | 必选 | 资产ID |
| amount | int | 可选 | 资产碎片数量，小于0和大于200000代表不做库存限制 asset_info、amount、price中要求至少有一个待更新 |
| price | int64 | 可选 | 藏品显示售卖价格，单位为分 |
| asset_info | string | 可选 | 资产信息 asset_info、amount、price中要求至少有一个待更新 |
| + asset_cate | int | 可选 | 资产分类。1：艺术品 2：收藏品 3：门票 4：酒店 |
| + title | string | 可选 | 资产名称，小于30个字节 |
| + thumb | array | 可选 | 资产缩略图。bos上传的图片，格式支持 ”jpg”, “png” 参数格式bos_v1://{bucket}/{object}/{width}_{height} |
| + short_desc | string | 可选 | 短文字描述，小于300个字节 |
| + img_desc | array | 可选 | 资产详情介绍长图。bos上传的图片，格式支持：”jpg”, “png”。参数格式bos_v1://{bucket}/{object}/{width}_{height} |
| + asset_url | array | 可选 | 资产原始文件。比如图片，图片本身就是资产。格式bos_v1://{bucket}/{object} ，建议文件大小<10M 具体格式要求参考接口描述上传文件格式要求 |
| + long_desc | string | 可选 | 长文字描述，小于1200个字节 |
| + asset_ext | string | 可选 | 资产额外描述信息json字符串。比如标签 |
| + group_id | int64 | 可选 | 资产组id。用于关联业务层酒店/店铺id |
| addr | string | 必选 | 创建资产账户地址 |
| sign | string | 必选 | 创建资产账户私钥签名，签名算法：msg = Sprintf(“%d%d”, asset_id, nonce)，sign = XassetSignECDSA(account, msg) |
| pkey | string | 必选 | 创建资产账户公钥 |
| nonce | int64 | 必选 | 随机数 |
响应头域
- 除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| errno | int | 错误码 0为成功，其他可参考常用错误码 |
| request_id | int | 后端生成，用于问题反馈，建议业务日志纪录 |
请求示例
Post xasset/horae/v1/alter
Host: xuper.baidu.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2022-04-18T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
asset_id=1332322111211
&amount=100
&price=100
&asset_info={
"asset_cate": 1,
"title": "猫的报恩",
"thumb": [
"bos_v1://xasset-trade/100100/md5.jpeg/1000_500"
],
"short_desc": "猫咪的可爱，仅此一份",
"long_desc": "我是长描述",
"img_desc": [
"bos_v1://xasset-trade/100100/md5.jpeg/1000_500"
],
"asset_url": [
"bos_v1://xasset-trade/100100/md5.gltf"
],
"asset_ext": {"tags":["艺术品","古董"]}
"group_id": 123123,
}
&addr=bFKZMPVBtUPb1bdoXzWwKX1jaSy9omMjR
&pubKey={"Curvname":"P-256","X":99992390283545488142355111780630053962942114118238766864067722901319912547387,"Y":62636249704255210574823120529280656364753347818712821209439354501575504249596}
&sign=B014EDF86B6DEE29E167E9D9ED9C5832
nonce=8856422235281354998响应示例
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"
{
"errno": 0,
"request_id": "1182282645",
}