FastAPI后台开发基础（14）： 路径装饰器

class Item(BaseModel):
    name: str
    description: str | None = None
    price: float
    tax: float | None = None
    tags: set[str] = ()


@app.post("/items/", response_model = Item, status_code = status.HTTP_201_CREATED)
async def create_item(item: Item):
    """
    注意：
        保证一致对齐，且使用空行进行分割，就可以自动换行

    场景：
        测试接口 默认 tag 为 default

    参数：
        此时没有指定 tags 参数
    """
    return item

@app.post('/items_2/', response_model = Item, tags = ['test_tag'])
async def create_item_2(item: Item):
    """
    示例：
    - 测试接口 用于测试 tags 参数
    - 测试指定了 tags 参数且只有一个值：test_tag
    """
    return item


@app.post('/items_3/', response_model = Item, tags = ['test_tag_1234', 'user_tag_interface'])
async def create_item_3(item: Item):
    """
    测试接口 用于测试 tags 参数

    此时指定了 tags 参数且有两个值

    中间空一行，这样就可以自动换行
    """
    return item

@app.post('/items_4/',
          response_model = Item,
          summary = '测试 summary 参数效果',
          response_description = '测试 response_description 参数效果',
          tags = ['测试 summary'])
async def create_item_4(item: Item):
    """
    测试接口 summary 和 response_description 参数效果
    """
    return item

@app.post('/items_5/',
          response_model = Item,
          summary = '测试 deprecated',
          deprecated = True,
          tags = ['deprecated'])
async def create_item_5(item: Item):
    """
    测试接口 deprecated 参数效果
    """
    return item