fastapi: 第四章：接收参数：查询参数

一，什么是查询参数？

查询参数是URL中?后面的部分，通常用来传递筛选条件或配置选项。

什么是查询参数？

看这个URL：http://localhost:8000/users?page=1&size=10&keyword=张三

page=1、size=10、keyword=张三就是查询参数。它们的特点是：

以?开头

多个参数用&连接

格式为key=value

顺序不重要

可以省略（可选）

 

二，例子：

@router.get("/one")
def get_user(user_id: int = 1,name: str = None):
    """根据ID获取单个用户"""
    return {"id": user_id, "name": f"用户{name}"}

说明：

这里的user_id、name就是查询参数。注意它们是在函数参数中直接定义的，没有使用任何特殊语法。

必填和可选：

如果参数有默认值（如user_id: int = 1），它就是可选的

如果没有默认值（如name: str），它就是必填的

访问/users/one?user_id=2&name=王富贵，FastAPI会自动提取这两个值并传入函数。

三，测试效果：