【FastAPI】P3 请求与响应-Toy模板网

这篇具有很好参考价值的文章主要介绍了【FastAPI】P3 请求与响应。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

在网络通讯中，请求（Request） 与 响应（Response） 扮演着至关重要的角色，它们构成了客户端与服务器间互动的根本理念。

请求，指的是客户端向服务器请求数据；
响应，指的是服务器发送给客户端的 HTTP 响应；

总的来说，当客户端向服务器发送一个 HTTP 请求时，服务器会处理这个请求，并返回一个 HTTP 响应。

请求

FastAPI，支持多种类型的请求数据，如路径参数、查询参数等。

路径参数

把参数设置在路径上，识别资源的具体实例。

# 参数 user_id 放在路径上，识别资源的具体实例。
@app.get("/users/{user_id}")

实现步骤：

1. 运行完整代码：

from fastapi import FastAPI

app = FastAPI()

@app.get("/users/{user_id}")
def get_user(user_id: int):
    return {"user_id": user_id}

2. 部署 uvicorn 服务器：

uvicorn main:app --reload

【FastAPI】P3 请求与响应,# FastAPI,fastapi

3. 通过网址访问：

http://127.0.0.1:8000/users/10010

查询参数

通过在路径后面添加问号（?）来附加查询参数，以提供额外的信息或者过滤条件。

@app.get("/users")
# 网址如下：
http://127.0.0.1:8000/users?user_id=10010&user_name=xuhongduo

实现步骤：

1. 运行完整代码：

from fastapi import FastAPI

app = FastAPI()

@app.get("/users/")
def get_user(user_id: int, user_name: str):
    return {"user_id": user_id, "user_name": user_name}

2. 部署 uvicorn 服务器：

# 如果已部署，那么无需重启，reload在代码修改时自动重启服务器
uvicorn main:app --reload

3. 通过网址访问：

http://127.0.0.1:8000/users/?user_id=10010&user_name=xuhongduo

响应

响应一般包含：

状态码：200表示成功，404表示未找到，500表示服务器错误等；
响应体：文本、JSON、二进制文本等；

FastAPI 支持多种类型的响应，包括 JSON 响应、文本响应、文件响应、重定向响应和错误响应。

JSON 响应

JSON 响应是最常用的响应类型，用于传输结构化数据。

return {"user_id": user_id, "user_name": user_name}

文本响应

文本响应发送纯文本数据。

return "Hello, World!"

返回 Pydantic 模型

路由处理函数返回一个 Pydantic 模型实例，FastAPI 将自动将其转换为 JSON 格式，并作为响应发送给客户端：

1. 运行完整代码：

from pydantic import BaseModel
from typing import Optional

class User(BaseModel):
    id: int
    name: str
    email: Optional[str] = None

from fastapi import FastAPI, HTTPException

app = FastAPI()

users = {
    1: {"name": "Alice", "email": "alice@example.com"},
    2: {"name": "Bob"},
}

@app.get("/users/{user_id}")
def read_user(user_id: int):
    user = users.get(user_id)
    if user:
        return user
    else:
        raise HTTPException(status_code=404, detail="User not found")