docs: update API spec — url returns pathname only, 30min cache expiration

This commit is contained in:
agentuser
2026-05-11 17:18:18 +08:00
parent a3100e61f4
commit 2f6c68a2e2
+4 -5
View File
@@ -42,7 +42,7 @@ paths:
code: 0
msg: "success"
data:
url: "http://localhost:6666/api/docx/download?id=d8d4122719c8465ea75ab62b37f6ce10"
url: "/api/docx/download?id=d8d4122719c8465ea75ab62b37f6ce10"
fileName: "annualReport.docx"
"400":
description: 参数校验失败(exportId 为空 / businessData 为空)
@@ -77,7 +77,7 @@ paths:
summary: 下载缓存的 DOCX 文件
description: |
根据 export 接口返回的 key 下载已生成的 DOCX 文件。
key 为临时 UUID,有效期不确定(服务重启后失效)。
key 为临时 UUID,生成后 30 分钟自动过期清理。
operationId: downloadDocx
tags:
- Docx Export
@@ -175,9 +175,8 @@ components:
properties:
url:
type: string
format: uri
description: 文件下载链接
example: "http://localhost:6666/api/docx/download?id=d8d4122719c8465ea75ab62b37f6ce10"
description: 文件下载路径(pathname only,无 origin)
example: "/api/docx/download?id=d8d4122719c8465ea75ab62b37f6ce10"
fileName:
type: string
description: 文件名