結果與下載
GET /api/v1/artifacts?job_id={job_id}GET /api/v1/artifacts/{artifact_id}產物只對所屬帳號可見。任務完成後再讀取產物清單。
GET /api/v1/artifacts/{artifact_id}/downloadcurl --fail-with-body -OJ \ https://omnidoc.top/api/v1/artifacts/6n2b7z5q8v4m1c3k/download \ -H "X-API-Key: $OMNIDOC_API_KEY"下載支援 ETag 與條件請求。大型檔案應使用串流寫入,請勿一次讀取至記憶體。
取得下載策略
Section titled “取得下載策略”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-urlHTML、SVG、XML 的結果始終以附件形式下載。
優先解析 RFC 5987 filename*,再回退到 filename。無論使用哪個值,都只取 basename,並按本地檔案系統規則截斷或替換非法字元。
一個任務可能返回多個產物或一個打包結果。以產物列表中的 format 和下載回應標頭為準,不根據原始檔案擴展名猜測回應類型。