1
import json
2

3
# Python 字典
4
person = {"name": "Alice", "age": 18}
5
print(person, type(person))         # {'name': 'Alice', 'age': 18} <class 'dict'>
6

7
# 转换为 JSON 字符串（序列化）
8
json_str = json.dumps(person)
9
print(json_str, type(json_str))     # {"name": "Alice", "age": 18} <class 'str'>

1
import json
2

3
# 序列化：Python → JSON
4
data = {"name": "Bob", "age": 25, "is_student": False}
5
json_string = json.dumps(data, ensure_ascii=False, indent=2)
6
print(json_string)
7
# {
8
#   "name": "Bob",
9
#   "age": 25,
10
#   "is_student": false
11
# }
12

13
# 反序列化：JSON → Python
14
json_input = '{"name": "Alice", "score": 95.5}'
15
parsed = json.loads(json_input)
16
print(parsed["name"])               # Alice
17
print(type(parsed))                 # <class 'dict'>

1
from fastapi import FastAPI
2
import uvicorn
3

4
# 创建 FastAPI 实例
5
app = FastAPI()
6

7
# 定义路由
8
@app.get("/")
9
def home():
10
    return {"message": "Hello World"}
11

12
# 启动服务器
13
if __name__ == "__main__":
14
    uvicorn.run(app, host="127.0.0.1", port=8000)

1
from fastapi import FastAPI
2

3
# 创建应用实例
4
app = FastAPI()
5
#     ↑
6
#     这个实例是 FastAPI 应用的核心
7
#     所有的路由、配置都注册在它上面
8

9
@app.get("/")
10
#  ↑      ↑
11
#  装饰器  路径
12
#  声明这是一个 GET 请求的处理函数
13
#  当访问根路径 "/" 时，执行下面的函数
14

15
def home():
16
    return {"message": "Hello World"}
17
    #      ↑
18
    #      返回字典，FastAPI 自动转换为 JSON

1
@app.get("/hello/{name}")
2
def say_hello(name: str):
3
    return {"message": f"Hello {name},欢迎来到我的网站！"}

1
用户访问: http://localhost:8000/hello/Alice
2
                ↓
3
FastAPI 匹配路径 "/hello/{name}"
4
                ↓
5
提取路径中的 "Alice" 作为 name 参数
6
                ↓
7
调用 say_hello(name="Alice")
8
                ↓
9
返回 JSON 响应

1
@app.get("/items/{item_id}")
2
def get_item(item_id: int):         # 声明为 int 类型
3
    return {"item_id": item_id}

1
GET /items/abc
2

3
响应:
4
{
5
  "detail": [
6
    {
7
      "loc": ["path", "item_id"],
8
      "msg": "value is not a valid integer",
9
      "type": "type_error.integer"
10
    }
11
  ]
12
}

1
# 固定路径（优先匹配）
2
@app.get("/users/me")
3
def get_current_user():
4
    return {"user": "current"}
5

6
# 路径参数
7
@app.get("/users/{user_id}")
8
def get_user(user_id: int):
9
    return {"user_id": user_id}

1
@app.get("/search")
2
def search(keyword: str, limit: int = 10):
3
    return {
4
        "你在找": keyword,
5
        "要几条": limit
6
    }

1
URL 结构:
2
http://localhost:8000/search?keyword=python&limit=10
3
                          ↑
4
                          ? 表示查询参数开始
5
                          keyword=python 第一个参数
6
                          & 分隔多个参数
7
                          limit=10 第二个参数

1
@app.get("/search")
2
def search(
3
    keyword: str,           # 必填参数（无默认值）
4
    limit: int = 10,        # 可选参数（有默认值）
5
    offset: int = 0         # 可选参数（有默认值）
6
):
7
    return {
8
        "keyword": keyword,
9
        "limit": limit,
10
        "offset": offset
11
    }

1
from typing import Optional
2

3
@app.get("/search")
4
def search(
5
    keyword: Optional[str] = None,   # 可以不传，默认为 None
6
    limit: int = 10
7
):
8
    if keyword:
9
        return {"搜索": keyword, "数量": limit}
10
    return {"提示": "请输入搜索关键词", "数量": limit}

1
if __name__ == "__main__":
2
    uvicorn.run(
3
        app,                # FastAPI 应用实例
4
        host="127.0.0.1",   # 监听地址
5
        port=8000,          # 监听端口
6
        reload=True         # 开发模式：代码修改自动重启（可选）
7
    )

1
import json
2

3
# Python → JSON
4
json_str = json.dumps(data, ensure_ascii=False, indent=2)
5

6
# JSON → Python
7
data = json.loads(json_str)

1
from fastapi import FastAPI
2
import uvicorn
3

4
app = FastAPI()
5

6
@app.get("/路径")
7
def 函数名(参数: 类型):
8
    return {"key": "value"}
9

10
if __name__ == "__main__":
11
    uvicorn.run(app, host="127.0.0.1", port=8000)

1
# 路径参数
2
@app.get("/items/{item_id}")
3
def get_item(item_id: int): ...
4

5
# 查询参数（有默认值）
6
@app.get("/search")
7
def search(keyword: str, limit: int = 10): ...
8

9
# 查询参数（可选）
10
from typing import Optional
11
@app.get("/search")
12
def search(keyword: Optional[str] = None): ...

1
@app.get("/items")      # 获取资源
2
@app.post("/items")     # 创建资源
3
@app.put("/items/{id}") # 更新资源（完整）
4
@app.patch("/items/{id}") # 更新资源（部分）
5
@app.delete("/items/{id}") # 删除资源