错误码和状态码
所有文档
menu

超级链数字商品可信登记平台 XuperAsset

错误码和状态码

产品详情

错误码和状态码

当用户访问API出现错误时,会返回给用户相应的错误码和错误信息,便于定位问题,并做出适当的处理。请求发生错误时通过Response Body返回详细错误信息,遵循如下格式:

参数 类型 描述
Code string 错误码
requestId string 本次请求的requestid 后端生成,用于问题反馈,建议业务日志纪录

公共错误码

下表列出了百度数字藏品API的公共错误码

错误码 错误码说明 所属模块 补充说明
0 成功 通用
40001 参数错误 通用 常见错误,可能错误原因 参数类型不正确 如int 传成了string,必须参数没传,bos_v1 字符串拼接不正确(如果此处拼接不正确,后续查看图片时会出nosuchkey)传递的account和碎片或者藏品的owner 不一致等
40002 签名错误 通用 使用sdk 几乎不会出现,多出现于自己封装鉴权时,可参考鉴权文档debug
40003 钱包地址和公钥不匹配 通用 少见错误,多会出现在客户从存储介质中获取信息重新形成account错误时出现
40004 签名过期 通用
40100 没有权限 通用 ak sk 错误
40300 拒绝请求 通用
40303 资产未发行,不允许上架 通用
40311 资产已存在,不允许重复创建 通用
40312 资产状态错误,不允许操作 通用 可以通过接口查询资产详情 通过status字段排查
40313 资产重复发行 通用
40314 资产库存不足 通用 资产碎片贩卖数已达到上限值amount,如果需要设置无库存限制,请在资产publish前提前修改amount=0,amount>20w的资产也被认定为无库存限制;出现该提示时,请仔细检查上层业务代码是否已经超卖
40315 碎片状态错误,不允许操作 通用 查看碎片详情 通过status 字段排查
40316 双花 通用 对相同碎片做重复的操作,比如重复授予、重复核销
40319 重复操作同一个碎片 通用
40320 重复操作同一个碎片 通用 重复操作同一个碎片,需要稍后重试
40342 百度智能云账户费用状态异常 通用
40343 服务已暂停 通用
40351 助记词重复绑定 身份管理 一个助记词只能绑定一次
40361 token无效 场景 一般是token格式错误、区块链地址不匹配、过期等
40362 用户未授权 场景 用户未授权该地址下藏品对外可查
40363 平台未授权 场景 平台未授权该平台下的产品对外可查
40380 操作太频繁 通用 相同地址下的碎片操作太频繁,请稍后重试
40400 资源未找到 通用
40401 文件不存在 通用
40402 资产不存在 资产仓库 指定asset/shard不存在,可能是APPID错误,或者碎片先前并没有授予成功(grant时返回错误需重试)导致碎片不存在,或者资产ID本身不存在
40407 用户不存在 身份管理 百度账号未找到绑定的区块链账户
40413 请求超限,频率控制 通用
50000 服务内部错误 通用
50002 创建重复资产 通用
50100 未实现接口 通用

公共状态码

当用户访问API成功后,会返回给用户相应的资产或者碎片的状态。便于及时了解资产和碎片状态

资产状态

参数 备注
1 初始化
3 发行中
4 发行成功
5 冻结中
6 已冻结
7 封禁中
8 已封禁
9 已删除

碎片状态

参数 备注
0 已上链
1 授予中
4 转移中
5 核销中
6 已核销
上一篇
公共请求头和响应头
下一篇
AIGC文生图