Conas a shainmhíníonn tú bealaí (path operations)?

Question

Accepted Answer

In FastAPI, is **path operation** a bhealaigh — feidhm a bhfuil gréine déanta aici le gréine modh HTTP (`@app.get`, `@app.post`, srl.) a dhéileálann le hiarratais ar bhealach. Déantar luach fillte an fheidhm a dhigitliú go JSON go huachtar.

## Bealaí a shainmhíniú do gach modh HTTP

```python
from fastapi import FastAPI
app = FastAPI()

@app.get("/items")                # GET /items
def list_items():
    return [{"id": 1}, {"id": 2}]  # dict/list → automatically JSON-serialized

@app.get("/items/{item_id}")      # GET /items/5 — path parameter
def get_item(item_id: int):        # type hint converts "5" → int (and validates)
    return {"id": item_id}

@app.post("/items")               # POST /items
def create_item(item: Item):
    return item

@app.put("/items/{item_id}")      # PUT, PATCH, DELETE work the same way
@app.delete("/items/{item_id}")
def delete_item(item_id: int):
    return {"deleted": item_id}
```

Mapáilíonn gach gréine modh HTTP + bealach ar láimhseoir. Is leatsa an t-ainm feidhme; sainmhíníonn an gréine an bealach. Déantar dicts/liostaí/samhlacha Pydantic ar ais a dhigitliú go JSON go huachtar — gan `json.dumps` láimhe.

## Tábhacht an ordaithe do bhealach a fhorluigíonn

```python
@app.get("/users/me")            # ✅ specific route FIRST
def read_me(): ...
@app.get("/users/{user_id}")     # dynamic AFTER — else "me" matches {user_id}
def read_user(user_id: int): ...
```

Loighníonn FastAPI bealaí san ord fhógra, mar sin cuir bealaí statacha roimh dhynamics.

## Meiteashonraí oibríochta (cothaítear na docs)

```python
@app.get("/items", tags=["items"], summary="List items", status_code=200)
def list_items(): ...
```

Cumraíonn paraiméadair an ghréine (`tags`, `summary`, `status_code`, `response_model`) iompar agus saibhríonn an doiciméadúchán ginte go huachtar.

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

Is bunús gach iarratas FastAPI a bhfuil siad ann — sainmhíníonn siad pointí deiridh do API agus conas a dhéileáltar le hiarratais.

Tá an patrún gréine-in-aghaidh-modh-HTTP a thuiscint, go ndéantar luachanna ar ais a dhigitliú go JSON go huachtar (gan boilerplate), go stiúraítear tipcí cineál ar pharaiméadair ar thiontú agus bailíochtú, agus go bhfuil ord na mbealaí tábhachtach do bhealach a fhorluigíonn ina eolas riachtanach go laethúil chun aon phointe deiridh a thógáil.

Thugann meiteashonraí an ghréine beatha freisin do doiciméadúchán uachtar FastAPI, ag nascadh bealaí go díreach do na docs.

Is é seo an chéad rud is bunúsaí a mhaistríonn i FastAPI.