docs(api): 补充 Swagger/Knife4j/OpenAPI 访问地址文档

2026-06-06 10:14:07 +08:00
parent 33351d3261
commit cfd2c44b80
1 changed files with 20 additions and 0 deletions
@@ -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 集合规范