ATKONBASE

外观

衍生物错误码（180*） ​

段位：180001 - 180999；当前 7 个 V1 暴露；同段其余为内部派生管道码，V1 不返回

通用约定（HTTP status / code=1 兜底 / 响应结构）见 README

经 V1 衍生物端点暴露：POST /v1/renditions/signed-url（按版本 + 类型签发短时直读 URL，返回 180001-180005）、GET /v1/versions/text（按版本取文本，衍生物字节读取失败时返回 180005-180006）、POST /v1/renditions/upload（客户端上传预览件，类型白名单校验返回 180014）。签名直读链路还会返回 存储错误码 173* 的签名直读子集（173009 有效期越界 / 173010 凭据无效 / 173011 预览 MIME 不可内联渲染）；上传时源版本不存在返回 资源访问错误码 187001。

180001 RENDITION_KIND_UNSUPPORTED ​

  • HTTP status：200
  • 含义：不支持的衍生物类型
  • 典型触发条件：POST /v1/renditions/signed-url 携带的 kind 不在系统放行集合内
  • 处理建议：使用受支持的衍生物类型（如 PREVIEW）
  • 示例响应：
json
{ "code": 180001, "msg": "不支持的衍生物类型", "data": null }

180002 RENDITION_NOT_FOUND ​

  • HTTP status：200
  • 含义：衍生物不存在
  • 典型触发条件：POST /v1/renditions/signed-url 指定的 versionId + kind 没有对应的衍生物记录
  • 处理建议：先确认该版本已存在对应类型的衍生物（客户端上传或平台派生）；可先调 GET /v1/renditions/list 列出某版本下的全部衍生物及其类型与状态
  • 示例响应：
json
{ "code": 180002, "msg": "衍生物不存在", "data": null }

180003 RENDITION_NOT_READY ​

  • HTTP status：200
  • 含义：衍生物尚未就绪
  • 典型触发条件：目标衍生物存在但状态非 READY（仍在产出或已失败），不可签发直读 URL
  • 处理建议：等待衍生物就绪后再签发——监听 rendition.uploaded Webhook 事件，或轮询 GET /v1/renditions/list 查 status
  • 示例响应：
json
{ "code": 180003, "msg": "衍生物尚未就绪", "data": null }

180004 RENDITION_HAS_NO_BLOB ​

  • HTTP status：200
  • 含义：衍生物未关联字节
  • 典型触发条件：目标衍生物标记为可用，但未关联任何字节内容，无法签发直读 URL
  • 处理建议：重新生成或重新上传该衍生物；持续出现请携响应中的 rid / X-Request-Id 联系支持团队
  • 示例响应：
json
{ "code": 180004, "msg": "衍生物未关联字节，无法读取", "data": null }

180005 RENDITION_BLOB_NOT_AVAILABLE ​

  • HTTP status：200
  • 含义：衍生物字节不可用
  • 典型触发条件：衍生物关联的存储对象尚不处于可用状态；POST /v1/renditions/signed-url 与 GET /v1/versions/text 取衍生物字节时均可能返回
  • 处理建议：稍后重试；若衍生物刚上传 / 刚派生，等待其字节落地后再取
  • 示例响应：
json
{ "code": 180005, "msg": "衍生物字节不可用", "data": null }

180006 RENDITION_DOWNLOAD_FAILED ​

  • HTTP status：200
  • 含义：衍生物读取 / 下载失败
  • 典型触发条件：GET /v1/versions/text 等读取衍生物字节时，存储读取或响应写出发生 IO 失败（服务端瞬时故障）
  • 处理建议：可重试；持续失败请携响应中的 rid / X-Request-Id 联系支持团队
  • 示例响应：
json
{ "code": 180006, "msg": "衍生物读取失败", "data": null }

180014 RENDITION_KIND_NOT_UPLOADABLE ​

  • HTTP status：200
  • 含义：该衍生物类型不允许客户端上传
  • 典型触发条件：POST /v1/renditions/upload 携带的 kind 不在可上传白名单内（当前仅 PREVIEW 可由客户端上传）
  • 处理建议：上传衍生物时使用 PREVIEW 类型；其它类型的衍生物由平台派生、不接受客户端上传。若上传的预览件 MIME 不可内联渲染，另见存储错误码 173011
  • 示例响应：
json
{ "code": 180014, "msg": "该衍生物类型不允许客户端上传", "data": null }