【FastAPI】1-url参数

fastapi的核心功能是提供HTTP请求接口

  • "幂等"和"非幂等"
    幂等(idempotent):如果一个方法重复执行多次,产生的效果是一样的,那么这个方法就是幂等的

"Methods can also have the property of "idempotence" in that the side-effects of N > 0 identical requests is the same as for a single request."

安全和幂等的意义在于:当操作没有达到预期的目标时,我们可以不停的重试,而不会对资源产生副作用。

  • 最常见的HTTP请求方法及其幂等性:
    GET、DELETE、POST、PUT

    在开发 API 时,通常使用特定的 HTTP 方法去执行特定的行为

通常使用:

POST:创 建数据。

GET: 读取数据。

PUT :更新数据。

DELET E:删除数据。

  • 在 OpenAPI 中,每一个 HTTP 方法都被称为「操作」

  • 路径参数 item_id 的值将作为参数 item_id 传递给开发者的函数

  • 所有的数据校验都由 Pydantic 在幕后完成

  • 预设值

  • 如果你有一个接收路径参数的路径操作,但你希望预先设定可能的有效参数值,则可以使用标准的 Python Enum 类型。

    创建一个 Enum 类 导入 Enum 并创建一个继承自 str 和 Enum 的子类。

    通过从 str 继承,API 文档将能够知道这些值必须为 string 类型并且能够正确地展示出来。

    然后创建具有固定值class ModelName(str, Enum),的类属性,这些固定值将是可

    然后使用你定义的枚举类(ModelName)创建一个带有类型标注的路径参数async def get_model(model_name: ModelName)的有效值

    可以使用 model_name.value 或通常来说 your_enum_member.value 来获取实际的值

  • 包含路径的路径参数

    可以使用直接来自 Starlette 的选项来声明一个包含路径的路径参数:
    /files/{file_path:path}

    在这种情况下,参数的名称为 file_path,结尾部分的 :path 说明该参数应匹配任意的路径

相关推荐
moonless02221 天前
FastAPI框架,这一小篇就能搞懂精髓。
http·fastapi
larance3 天前
fastapi 使用本地资源自定义swagger文档
fastapi
肥肠可耐的西西公主4 天前
后端(FastAPI)学习笔记(CLASS 3):Tortoise ORM
笔记·学习·fastapi
onelafite5 天前
小红书笔记评论一键获取,实时查看作品数据
api·fastapi
shao9185165 天前
Gradio全解11——Streaming:流式传输的视频应用(2)——Twilio:网络服务提供商
fastapi·handler·stun·turn·ice·twillo
枫叶V6 天前
用 FastAPI 实现大文件分片上传与断点续传(含可运行示例与客户端脚本,仅供参考)
python·fastapi
蓝倾9 天前
利用API接口合规获取淘宝店铺所有商品实战案例(2025年最新版)
api·fastapi
肥肠可耐的西西公主10 天前
后端(fastAPI)学习笔记(CLASS 1):扩展基础
笔记·学习·fastapi
红鼻子时代11 天前
Day5-中间件与请求处理
中间件·fastapi·后端开发
蓝倾12 天前
京东商品属性API数据解析:颜色、尺寸与材质
api·fastapi