Partial update/PATCH trong FastAPI nên thiết kế thế nào?

PATCH nên dùng model riêng với fields optional, sau đó chỉ apply field nào client gửi. Với Pydantic v2, model_dump(exclude_unset=True) giúp phân biệt field không gửi với field gửi giá trị null.

Ví dụ:

class UserPatch(BaseModel):
    name: str | None = None
    bio: str | None = None

changes = payload.model_dump(exclude_unset=True)

Không nên reuse model create cho PATCH vì create thường required fields, còn PATCH phải biểu diễn partial mutation.

PATCH should use a separate model with optional fields, then apply only fields sent by the client. With Pydantic v2, model_dump(exclude_unset=True) distinguishes missing fields from fields explicitly sent as null.

Example:

class UserPatch(BaseModel):
    name: str | None = None
    bio: str | None = None

changes = payload.model_dump(exclude_unset=True)

Do not reuse the create model for PATCH because create usually has required fields while PATCH represents partial mutation.