Selain semakan jenis, FastAPI membenarkan anda menambah kekangan (constraints) pada parameter laluan/pertanyaan dan medan model menggunakan Query, Path, dan Field — menguatkuasakan peraturan seperti panjang, julat, dan corak, dengan ralat 422 automatik serta dokumentasi apabila dilanggar.
from fastapi import Query, Path
@app.get("/items")
def search(
q: str = Query(min_length=3, max_length=50), # string length bounds
page: int = Query(default=1, ge=1), # >= 1
limit: int = Query(default=10, ge=1, le=100), # 1 <= limit <= 100
code: str = Query(pattern=r"^[A-Z]{3}$"), # regex pattern
):
...
@app.get("/items/{item_id}")
def get(item_id: int = Path(ge=1)): # path param must be >= 1
...
Query() dan Path() menambah kekangan pada parameter pertanyaan dan laluan. Yang biasa: min_length/max_length (rentetan), ge/gt/le/lt (nombor), pattern (regex). Pelanggaran menghasilkan ralat 422 yang jelas secara automatik.
from pydantic import BaseModel, Field, EmailStr
class User(BaseModel):
name: str = Field(min_length=1, max_length=100)
age: int = Field(ge=0, le=120)
email: EmailStr # format validation via a type
bio: str = Field(default="", max_length=500, description="User bio")
Kekangan yang sama dikenakan pada medan model melalui Field(), mengesahkan badan permintaan. Jenis khusus (EmailStr, HttpUrl, UUID) mengesahkan format.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Setiap kekangan yang anda isytiharkan turut digambarkan dalam dokumentasi OpenAPI, jadi pengguna melihat peraturan tersebut.
Menambah kekangan validasi adalah penting untuk kedua-dua keselamatan/keteguhan dan reka bentuk API yang baik — mengisytiharkan peraturan (had panjang, julat berangka, corak regex, jenis format) memastikan input yang cacat atau berniat jahat ditolak dengan ralat yang jelas sebelum sampai ke logik anda, yang penting kerana anda tidak boleh sekali-kali mempercayai input mentah.
FastAPI menjadikan ini deklaratif dan mudah: kekangan Query/Path/Field disahkan secara automatik (menghasilkan ralat 422 berstruktur) dan didokumentasikan serentak dalam dokumentasi API, jadi peraturan dikuatkuasakan dan disampaikan daripada satu pengisytiharan tunggal.
Mengetahui kekangan biasa dan jenis validasi khusus ialah pengetahuan harian untuk membina endpoint yang selamat dan jelas takrifannya — ia adalah cara anda melangkaui semakan jenis asas untuk menguatkuasakan peraturan perniagaan sebenar yang mesti dipenuhi oleh data anda.