跳到內容

結果與下載

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

產物只對所屬帳號可見。任務完成後再讀取產物清單。

GET /api/v1/artifacts/{artifact_id}/download
Terminal window
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 和下載回應標頭為準,不根據原始檔案擴展名猜測回應類型。