结果与下载

查询产物

GET /api/v1/artifacts?job_id={job_id}
GET /api/v1/artifacts/{artifact_id}

产物只对所属账号可见。任务完成后再读取产物列表。

直接下载

GET /api/v1/artifacts/{artifact_id}/download

curl --fail-with-body -OJ \
  https://omnidoc.top/api/v1/artifacts/6n2b7z5q8v4m1c3k/download \
  -H "X-API-Key: $OMNIDOC_API_KEY"

下载支持 ETag 与条件请求。大文件应使用流式写入，不要一次读入内存。

获取下载策略

GET /api/v1/artifacts/{artifact_id}/download-link

返回：

{
  "mode": "direct",
  "url": "https://download.example/...",
  "filename": "report.en.docx"
}

客户端必须同时支持 url 为 null 的情况，此时使用直接下载端点。短时 URL 过期后重新获取。

预览

GET /api/v1/artifacts/{artifact_id}/preview-url

HTML、SVG、XML 结果始终以附件形式下载。

文件名处理

优先解析 RFC 5987 filename*，再回退到 filename。无论使用哪个值，都只取 basename，并按本地文件系统规则截断或替换非法字符。

一个任务可能返回多个产物或一个打包结果。以产物列表中的 format 和下载响应头为准，不根据原文件扩展名猜测响应类型。