From 2f6c68a2e225af48bd6e6d307b2172640e52e13c Mon Sep 17 00:00:00 2001
From: agentuser <agentuser@gmp-service>
Date: Mon, 11 May 2026 17:18:18 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20update=20API=20spec=20=E2=80=94=20url?=
 =?UTF-8?q?=20returns=20pathname=20only,=2030min=20cache=20expiration?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/openapi.yaml | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 5d9abe4..13e1289 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -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: 文件名