如何 link 外部 swagger json 文件到 Python FastAPI?

How to link an external swagger json file to Python FastAPI?

我有一个 swagger JSON 文件,我想 link 我的 Python FastAPI 脚本来替换默认的 /docs 自动生成的文件,任何想法我怎样才能做到这一点?

没有内置的方法来执行此操作,但您可以通过遵循 the documentation.

轻松地 override/extend openapi

这是一个关于如何实现预期结果的小代码示例:

from fastapi import FastAPI
import json

app = FastAPI()

def custom_openapi():
    with open("openapi.json", "r") as openapi:
        return json.load(openapi)

app.openapi = custom_openapi

结果:

请注意,尽管使用此方法使文档保持最新和准确会很痛苦,而且您会丢掉一大块 FastAPIs 功能集:我强烈建议不要这样做它。