FastAPI 学习之路（二十）接口文档配置相关

原创

已于 2022-11-24 22:00:47 修改 · 2.3k 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#fastapi

于 2022-08-29 14:47:47 首次发布

本文介绍如何使用FastAPI对API接口进行分组、添加描述及标记接口为废弃的方法。通过实例演示了如何设置tags参数来组织接口，并展示了如何利用summary和description参数增强文档的可读性。

我们都知道，fastApi给我们提供了接口文档，在我们的实际开发中，我们会有很多的接口，有些接口需要分组，比如我们对于登录注册相关的模块，可以统一放在登录，那么我们如何实现划分呢。

from fastapi import FastAPI

app = FastAPI()


@app.post("/login", tags=["login"])
def login(username: str, password: str):
    if username == "lc" and password == "123":
        return "success"
    return {"msg": "name or password error"}


@app.post("/register", tags=["login"])
def resgister(username: str, password: str):
    return {"msg": "success"}

我们看下，接口文档

可以看到，我们实现的登录的模块是成功的。

我们来看下，如何对接口增加一个简单的描述（增加description参数）

from fastapi import FastAPI

app = FastAPI()


@app.post("/login", tags=["login"], description="这是登录接口")
def login(username: str, password: str):
    if username == "lc" and password == "123":
        return "success"
    return {"msg": "name or password error"}


@app.post("/register",