Thairis ar sheiceáil cineál, ligeann FastAPI duit srianta a chur le paraiméadair cosáin/cheiste agus réimsí samhail ag úsáid Query, Path, agus Field — ag fhorfheidhmiú rialacha ar nós fad, raonanna agus patrúin, le hearráidí 422 uathoibríocha agus doiciméadú nuair a bhriseadh iad.
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
...
Cuireann Query() agus Path() srianta le paraiméadair ceiste agus cosáin. Cinn choitianta: min_length/max_length (teaghráin), ge/gt/le/lt (uimhreacha), pattern (regex). Tháirgeann sáruithe earráid 422 soiléir go huathoibríoch.
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")
Baineann na srianta céanna le réimsí samhail trí Field(), ag bhailíochtú corps iarratas. Bailíonn cineálacha speisialaithe (EmailStr, HttpUrl, UUID) formáidí.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Tá gach srian a dhearbhaíonn tú freisin léirithe sa doiciméadúchán OpenAPI, ionas go bhfeiceann tomhaltóirí na rialacha.
Tá sé tábhachtach srianta bailíochtaithe a chur leis do shlándáil/dhobhéasacht agus dea-dhearadh API — rialacha a dhearbhú (teorainneacha fad, raonanna uimhriúla, patrúin regex, cineálacha formáide) a chinntiú go ndéantar ionchur tobhach nó mailíseach a dhiúltú le hearráidí soiléir sula sroicheann sé do loighic, atá ríthábhachtach toisc nach gcaithfidh tú ionchur amh a bheith muiníneach ann riamh.
Déanann FastAPI seo dearbhaitheach agus gan dua: bhaileofar srianta Query/Path/Field go huathoibríoch (earráidí 422 struchtúrtha a tháirgeadh) agus ar an am céanna doiciméadaithe san doiciméadúchán API, ionas go bhfuil na rialacha fheidhmeanna agus tuairiscithe ó dhearbhú amháin.
Bheith ar an eolas ar na srianta coitianta agus cineálacha bailíochtaithe speisialaithe is eolas laethúil chun deireadh amháin a chur ar bhonn slán, dea-shainmhínithe — sin an chaoi ar a dtéann tú thairis ar shheiceáil cineál bunúsach chun rialacha ghnó iarbhír a bhfuil do chuid sonraí ort a shásamh a chur i bhfeidhm.