Conas a fheidhmíonn paraiméadair cosáin agus paraiméadair fiosrúcháin?

Question

Accepted Answer

Baineann FastAPI **paraiméadair cosáin** (cuid de conair an URL) agus **paraiméadair fiosrúcháin** (tar éis `?`) ó argóintí feidhme, ag baint úsáide as himplicití cineál chun iad a thiontú agus a bhailíochtú go huathoibríoch.

## Paraiméadair cosáin — cuid den URL

```python
@app.get("/items/{item_id}")        # {item_id} in the path
def get_item(item_id: int):          # matched by NAME; `int` converts & validates
    return {"item_id": item_id}
# GET /items/5 → item_id = 5 (int).  GET /items/abc → 422 error (not an int)
```

Baineann paraiméadar feidhme ar comhainm le `{placeholder}` sa chosain **paraiméadar cosáin** a dhéanamh. Déanann an implicití cineál (`int`) an teanga a thiontú go huathoibríoch ó an URL agus tugann sé earráid soiléir 422 ar ais mura bhfreagraíonn sé.

## Paraiméadair fiosrúcháin — gach rud eile

```python
@app.get("/items")
def list_items(skip: int = 0, limit: int = 10, q: str | None = None):
    # parameters NOT in the path become QUERY parameters
    # GET /items?skip=20&limit=5&q=phone → skip=20, limit=5, q="phone"
    return {"skip": skip, "limit": limit, "q": q}
```

Baineann paraiméadair feidhme **nach** bhfuil sa chosain **paraiméadair fiosrúcháin** a dhéanamh. Déanann luach réamhshocraithe iad roghnach (`skip: int = 0`) ; `str | None = None` a dhéanann paraiméadar fiosrúcháin optúil nullable. Gan luach réamhshocraithe, tá siad ag teastáil.

## Riachtanach vs roghnach

```python
def search(q: str):              # REQUIRED query param (no default) → ?q=... must be present
def search(q: str = ""):          # optional, defaults to ""
def search(q: str | None = None): # optional, defaults to None
```

## An dá rud a chomhcheangal

```python
@app.get("/users/{user_id}/items")
def user_items(user_id: int, limit: int = 10):
    # user_id = path param, limit = query param — distinguished by the path
```

## Cén fáth a bhfuil sé tábhachtach

Paraiméadair cosáin agus fiosrúcháin an bhealach ina bhfaigheann críochfoirt ionchuir ó an URL — bunúsach do thuairim gach bealach API (acmhainn a fháil trí id, scagadh, leathanaigh, cuardach).

Tá cur chuige FastAPI geal agus cúis bhunúsach ar chúis é a bhfuil sé táirgiúil: paraiméadair feidhme clóite a dhearbhú go simplí a thugann duit an eastóchán go huathoibríoch, **tiontú cineál**, **bailíochtú** (le hearráidí 422 soiléir ar ionchur olc) agus séimeantaic riachtanach-ar-fhan (trí réamhshocruithe) — gach rud a fhorghníomhaithe ó himplicití cineál Python caighdeánach, gan parsáil láimhe.

Tá an idirdhealú a thuiscint (tagann paraiméadair cosáin ó `{placeholders}`, tá gach rud eile ina pharaiméadar fiosrúcháin) agus conas a rialaiann réamhshocruithe an roghnachas ríthábhachtach gach lá do dhul i ngleic le críochfoirt FastAPI a thógáil.