2. fastApi路径参数详解

FastAPI 使用 Python 字符串格式化语法声明路径参数（变量）：

示例1

from fastapi import FastAPI
app = FastAPI()
@app.get("/items/{item_id}")
async def read_item(item_id):
    return {"path arg ==> item_id": item_id}

示例1结果

swagger页面展示

fastApi对于路径参数类型的支持

在试图函数内，指定参数的类型，对应的swagger展示的页面就会对测试的参数类型进行限制，不符合规则的请求参数会被过滤，不允许发送到后端，减少因为参数类型引起的测试与开发问题。

参数类型限制

示例2

@app.get("/argsTypeLimit/{item_id}")
async def read_item(item_id: int):  # int类型限制
    return {"path arg ==> item_id": item_id}

由于试图函数限制了路径参数item_id的类型，swagger测试页面则会相应得限制请求的发送，过滤不合理请求【不符合条件的请求不会发送到后端】。如下展示了符合条件的参数与不符合条件的参数测试情况。
符合条件的参数：


不符合条件的参数：

使用Path类高级限制

示例3

目标：在路由/path_/后传递一个路径参数，同时限制参数为数字，参数范围1-10之间
实现方案：使用fastapi内的Path方法校验参数
实现代码：

from fastapi import FastAPI,Path
@app.get("/path_/{num}")  # 指定数字
def path_params_validate(
        num: int = Path(..., description="数字路径参数接口测试", ge=1, le=10),
):# description为参数描述，ge为大于等于，le为小于等于
    return num

解释：使用Path方法处理数字类型的参数，可以限制参数的范围，同时在API内可以对参数进行描述
效果展示:

1. 在范围内的参数测试
   
2. 不在范围内的参数测试 ==>会提示参数不在范围内，不允许通过API测试接口
   

枚举类型的参数使用

以下方法主要用于为swagger测试接口提供选择框,便于前后端交互与接口测试

from enum import Enum
# 设置枚举类，用于数据限制
class CityName(str, Enum):
    Beijing = "Beijing China"
    Shanghai = "Shanghai China"
@app.get("/enum/{city}") 
async def latest(city: CityName): # 数据类型为定义好的枚举类
    if city == CityName.Shanghai:
        return {"city_name": city, "confirmed": 1492, "death": 7}
    if city == CityName.Beijing:
        return {"city_name": city, "confirmed": 971, "death": 9}
    return {"city_name": city, "latest": "unknown"}

效果展示:

路径参数内含有"/"处理

在不做任何设置之前，框架会将参数中的/当作路径来解析，结果可能导致匹配不到正确路径，引起404报错。
不对参数处理做设置之前可能发生如下情况：

我们需要实现的功能：将参数作为字符串来处理，忽略了其中的关键字符"/"
实现代码：

@app.get("/files/{file_path:path}")  # 通过指定装饰器内的参数类型为path,将/files/后的所有数据作为字符串处理
def filepath(file_path: str):
    return f"The file path is {file_path}"

通过以上方式，将/files/后的参数作为字符串处理，使其匹配到对应的filepath试图