本文主要是介绍【FastAPI】P3 请求与响应,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
目录
- 请求
- 路径参数
- 查询参数
- 响应
- JSON 响应
- 文本响应
- 返回 Pydantic 模型
在网络通讯中,请求(Request) 与 响应(Response) 扮演着至关重要的角色,它们构成了客户端与服务器间互动的根本理念。
- 请求,指的是客户端向服务器请求数据;
- 响应,指的是服务器发送给客户端的 HTTP 响应;
总的来说,当客户端向服务器发送一个 HTTP 请求时,服务器会处理这个请求,并返回一个 HTTP 响应。
请求
FastAPI,支持多种类型的请求数据,如路径参数、查询参数等。
路径参数
把参数设置在路径上,识别资源的具体实例。
# 参数 user_id 放在路径上,识别资源的具体实例。
@app.get("/users/{user_id}")
实现步骤:
1. 运行完整代码:
from fastapi import FastAPIapp = FastAPI()@app.get("/users/{user_id}")
def get_user(user_id: int):return {"user_id": user_id}
2. 部署 uvicorn 服务器:
uvicorn main:app --reload
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 FastAPIapp = 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 Optionalclass User(BaseModel):id: intname: stremail: Optional[str] = Nonefrom fastapi import FastAPI, HTTPExceptionapp = 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 userelse:raise HTTPException(status_code=404, detail="User not found")
2. 通过网址访问:
http://127.0.0.1:8000/users/1
3. FastAPI 自动将 Pydantic 模型实例转换为 JSON 格式:
有关 FastAPI Pydantic 模型,请看 【FastAPI】P4 FastAPI Pydantic
以上
如有任何问题,请联系或留言,谢谢
2024.2.19
这篇关于【FastAPI】P3 请求与响应的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!