网站设计策划书模板,哪个公司做网站推广最好,域名 和网站有什么区别吗,做游戏能赚钱的网站要自定义 FastAPI 中的 Swagger UI#xff0c;且使用本地资源来代替 CDN。只是需要稍微修改一下。
修改后的代码#xff1a;
步骤#xff1a;
挂载本地静态文件目录#xff1a;我们将本地的 Swagger UI 资源文件#xff08;如 .js, .css, favicon.png 等#xff09;放…要自定义 FastAPI 中的 Swagger UI且使用本地资源来代替 CDN。只是需要稍微修改一下。
修改后的代码
步骤
挂载本地静态文件目录我们将本地的 Swagger UI 资源文件如 .js, .css, favicon.png 等放置在项目的一个目录中例如static/swagger-ui。自定义 Swagger UI 页面您可以通过 FastAPI 的 get_swagger_ui_html() 方法来加载本地的 Swagger UI 页面。
修改后的代码
from fastapi import FastAPI
from fastapi.responses import HTMLResponse
from fastapi.staticfiles import StaticFiles
from fastapi.openapi.docs import get_swagger_ui_htmlapp FastAPI(docs_urlNone, # 禁用默认的 Swagger UI 地址redoc_urlNone # 禁用 ReDoc 默认地址
)# Step 1: Mount the static directory for Swagger UI resources
app.mount(/static, StaticFiles(directorystatic), namestatic)# Step 2: Define custom Swagger UI route
app.get(/docs, include_in_schemaFalse)
async def custom_swagger_ui():return get_swagger_ui_html(openapi_url/openapi.json, # 指定 OpenAPI 文档路径titleAPI Docs, # 自定义页面标题swagger_js_url/static/swagger-ui/swagger-ui-bundle.js, # 本地 JS 文件swagger_css_url/static/swagger-ui/swagger-ui.css, # 本地 CSS 文件swagger_favicon_url/static/swagger-ui/favicon.png # 本地 favicon 图标)解释 禁用默认的 Swagger UI docs_urlNone, # 禁用默认的 Swagger UI 地址
redoc_urlNone # 禁用 ReDoc 默认地址通过设置 docs_urlNone 和 redoc_urlNone您禁用了 FastAPI 默认提供的 Swagger UI 和 ReDoc 文档路径。 挂载静态文件目录 app.mount(/static, StaticFiles(directorystatic), namestatic)这行代码将本地 static 目录挂载为静态文件服务。Swagger UI 资源文件应该放在 static/swagger-ui 目录下。 自定义 Swagger UI 页面 app.get(/docs, include_in_schemaFalse)
async def custom_swagger_ui():return get_swagger_ui_html(openapi_url/openapi.json,titleAPI Docs,swagger_js_url/static/swagger-ui/swagger-ui-bundle.js,swagger_css_url/static/swagger-ui/swagger-ui.css,swagger_favicon_url/static/swagger-ui/favicon.png)get_swagger_ui_html() 是 FastAPI 提供的函数用于生成 Swagger UI 的 HTML 页面。您可以在其中自定义 openapi_url指定您的 OpenAPI 文档 URL。swagger_js_url、swagger_css_url、swagger_favicon_url指定 Swagger UI 需要的本地资源文件路径。
本地文件结构
您的文件夹结构应该如下
project/
│
├── app.py # FastAPI 代码
├── static/
│ └── swagger-ui/
│ ├── swagger-ui.css
│ ├── swagger-ui-bundle.js
│ ├── swagger-ui-standalone-preset.js
│ └── favicon.png访问 Swagger UI
启动应用后访问 http://127.0.0.1:8000/docs您应该可以看到加载了本地资源的 Swagger UI 页面而不再依赖外部 CDN。
这样您就可以使用 FastAPI 提供的本地资源来定制 Swagger UI 了。
