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