Kif żżid limitazzjonijiet ta' validazzjoni għall-parametri?

Question

Accepted Answer

Lil là minn `type` checking, FastAPI tħalluk żżid **limitazzjonijiet** għal parametri ta' path/query u fields tal-mudelli billi tuża `Query`, `Path`, u `Field` — infurzar ir-regoli bħal tul, ranges, u patterns, b'erruri 422 awtomatiċi u dokumentazzjoni meta jsiru vjalati. ## Limitazzjonijiet ta' Query u Path ```python 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()` u `Path()` żżidu limitazzjonijiet għall-parametri ta' query u path. Dawk komuni: `min_length`/`max_length` (strings), `ge`/`gt`/`le`/`lt` (numri), `pattern` (regex). Violazzjonijiet jiprodużu errar 422 ċar awtomatikament. ## Limitazzjonijiet ta' Field fuq mudelli Pydantic ```python 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") ``` L-istess limitazzjonijiet japplikaw għal fields tal-mudelli permezz ta' `Field()`, validar tal-request bodies. Tipi speċjalizzati (`EmailStr`, `HttpUrl`, `UUID`) jvalidaw formati. ## Limitazzjonijiet jissakknu wkoll id-docs ```python q: str = Query(min_length=3, description="Search query", example="phone") # the constraints + description + example appear in the auto-generated API docs ``` Kull limitazzjoni li tiddikjara hija riflessa wkoll fid-dokumentazzjoni OpenAPI, sabiex il-konsumers jirrikonoxxu r-regoli. ## Għaliex hu importanti Iż-żieda ta' limitazzjonijiet ta' validazzjoni hu importanti għal **sigurtà/robustezza** u għal disinn tajjeb tal-API — jiddikjara r-regoli (limiti ta' tul, ranges numeriċi, patterns regex, tipi ta' format) ifisser li l-input deformu jew malintennut jitwaqqa' b'erruri ċari *qabel* jilħqu l-loġika tiegħek, li hu essenzjali peress li qatt m'għandek tfiduċ input mhux ipproċessat. FastAPI jagħmel dan deklarativu u effortless: limitazzjonijiet ta' `Query`/`Path`/`Field` jiġu validati awtomatikament (jiprodużu erruri strutturati 422) u simultaneament dokumentati fid-docs tal-API, allura r-regoli jiġu infurzati u komunikati minn dikjarazzjoni waħda. L-għarfien tal-limitazzjonijiet komuni u tipi ta' validazzjoni speċjalizzata hu għarfien tal-yum għall-bini ta' endpoints siguri u djaruni mgħarrifin — dan hu kif tmur lil là minn `type` checking bażiku biex tinfurzar ir-regoli tal-negozju attwali li d-data tiegħek irid tissodisfa.