From cfd2c44b803b228e3b3cd25c92f22de84e75ab04 Mon Sep 17 00:00:00 2001 From: pigeon Date: Sat, 6 Jun 2026 10:14:07 +0800 Subject: [PATCH] =?UTF-8?q?docs(api):=20=E8=A1=A5=E5=85=85=20Swagger/Knife?= =?UTF-8?q?4j/OpenAPI=20=E8=AE=BF=E9=97=AE=E5=9C=B0=E5=9D=80=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- standards/API设计规范.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/standards/API设计规范.md b/standards/API设计规范.md index efe434a..d75e10c 100644 --- a/standards/API设计规范.md +++ b/standards/API设计规范.md @@ -428,6 +428,8 @@ springdoc: ### 12.2 访问地址 +#### Swagger UI 页面 + ``` http://localhost:9300/swagger-ui.html # 网关聚合文档 http://localhost:9301/swagger-ui.html # 认证服务文档 @@ -435,6 +437,24 @@ http://localhost:9302/swagger-ui.html # 系统服务文档 http://localhost:9303/swagger-ui.html # 用户服务文档 ``` +#### Knife4j 增强 UI（推荐） + +``` +http://localhost:9300/doc.html # 网关聚合文档 +http://localhost:9301/doc.html # 认证服务文档 +http://localhost:9302/doc.html # 系统服务文档 +http://localhost:9303/doc.html # 用户服务文档 +``` + +#### OpenAPI JSON 接口 + +``` +http://localhost:9300/v3/api-docs # 网关聚合 API 文档 +http://localhost:9301/v3/api-docs # 认证服务 API 文档 +http://localhost:9302/v3/api-docs # 系统服务 API 文档 +http://localhost:9303/v3/api-docs # 用户服务 API 文档 +``` + --- ## 十三、Postman / APIFox 集合规范