fastapi 请求头参数

FastAPI 是一个现代、快速（高性能）的 Web 框架，用于构建 API。它基于 Python 3.6+ 类型提示，使用了 ASGI（异步服务器网关接口）。FastAPI 具有自动交互式文档、验证和序列化等多种特性。关于请求头参数，FastAPI 允许你在函数的参数中直接声明它们，FastAPI 会自动处理，并将它们作为函数参数传递。

在 FastAPI 中，请求头参数通常是通过在函数参数前加上 `Header` 来指定的。这里是一个例子：

from fastapi import FastAPI, Header

app = FastAPI()

@app.get("/items/")
async def read_items(x_token: str = Header(...)):
    return {"X-Token passed": x_token}

在这个例子中，`x_token` 是一个请求头参数。使用 `Header(...)` 声明表示该参数是必需的。如果客户端的请求中没有包含 `x_token`，FastAPI 将返回 422 错误，表示客户端的请求格式有误。

`Header` 也可以用来声明请求头参数是可选的，或者有一个默认值。如果设置了默认值，则该参数变成可选的。例如：

from fastapi import FastAPI, Header

app = FastAPI()

@app.get("/items/")
async def read_items(x_token: str = Header(None)):
    return {"X-Token is not passed": x_token}

在这个修改后的例子中，`x_token` 参数是可选的，客户端可以不传递它。

此外，还可以使用 `Header` 来对请求头参数进行验证，比如验证其是否符合特定的模式或类型。FastAPI 使用 Pydantic 模型来进行验证，这使得处理请求数据变得非常方便和强大。