错误码和状态码
更新时间：2023-11-06
错误码和状态码
当用户访问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 | 已核销 |