Selain pemeriksaan tipe, FastAPI memungkinkan Anda menambahkan batasan ke parameter jalur/kueri dan bidang model menggunakan Query, Path, dan Field — menerapkan aturan seperti panjang, rentang, dan pola, dengan kesalahan 422 otomatis dan dokumentasi saat 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() menambahkan batasan ke parameter kueri dan jalur. Yang umum: min_length/max_length (string), ge/gt/le/lt (angka), pattern (regex). Pelanggaran menghasilkan kesalahan 422 yang jelas secara otomatis.
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")
Batasan yang sama berlaku pada bidang model melalui Field(), memvalidasi badan permintaan. Tipe khusus (EmailStr, HttpUrl, UUID) memvalidasi format.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Setiap batasan yang Anda deklarasikan juga tercermin dalam dokumentasi OpenAPI, sehingga konsumen melihat aturannya.
Menambahkan batasan validasi penting untuk keamanan/ketangguhan dan desain API yang baik — mendeklarasikan aturan (batas panjang, rentang numerik, pola regex, tipe format) memastikan input yang tidak sesuai format atau berbahaya ditolak dengan kesalahan yang jelas sebelum mencapai logika Anda, yang penting karena Anda tidak boleh pernah mempercayai input mentah.
FastAPI membuat ini deklaratif dan tanpa usaha: batasan Query/Path/Field divalidasi secara otomatis (menghasilkan kesalahan 422 terstruktur) dan secara bersamaan didokumentasikan dalam dokumentasi API, sehingga aturan diterapkan dan dikomunikasikan dari satu deklarasi.
Mengetahui batasan umum dan tipe validasi khusus adalah pengetahuan sehari-hari untuk membangun endpoint yang aman dan terdefinisi dengan baik — cara Anda melampaui pemeriksaan tipe dasar untuk menerapkan aturan bisnis aktual yang harus dipenuhi data Anda.