Kif tiddefinisci l-irruottiet (operazzjonijiet tal-path)?

Question

Accepted Answer

F'FastAPI, **operazzjoni tal-path** hija rotta — funzjoni ddikjarata b'dekoratur ta' metodu HTTP (`@app.get`, `@app.post`, eċċ) li tippruċessa talbiet għal path. Il-valur li jirritorna l-funzjoni jiġi serializzat awtomatikament għal JSON.

## Tiddifiniċi tal-irruottiet għal kull metodu 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}
```

Kull dekoratur imappja metodu HTTP + path għal handler. L-isem tal-funzjoni huwa tiegħek; id-dekoratur jiddefinisci r-rotta. Dictionary/listi/modelli Pydantic li jirritornaw jiġu serializzati awtomatikament għal JSON — mingħajr `json.dumps` manuali.

## L-ordni huwa importanti għal paths li jissovrapponjaw

```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): ...
```

FastAPI taqbel mir-rutti fl-ordni tad-dikjarazzjoni, allura poġġi l-paths statiċi qabel dawk dinamiċi.

## Metadati tal-operazzjoni (ikixter id-docs)

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

Il-parametri tad-dekoratur (`tags`, `summary`, `status_code`, `response_model`) jikkonfiguraws il-kmien u jgħin bid-dokumentazzjoni li tiġi ġġenerata awtomatikament.

## Għaliex hija importanti

L-operazzjonijiet tal-path huma l-bażi ta' kull applikazzjoni FastAPI — jiddefinisċu l-endpoints tal-API tiegħek u kif jittrattaw ir-ritkesti.

L-għarfien tal-pattern dekoratur-għal-metodu-HTTP, li l-valuri li jirritornaw jiġu serializzati awtomatikament għal JSON (mingħajr boilerplate), li l-ipinzelli tat-tip fuq parametri jiddrivaw il-konverżjoni u l-validazzjoni, u li l-ordni tar-rotta hija importanti għal paths li jissovrapponjaw, hija għarfien essenzjali ta' kull jum għall-bini ta' endpoint kunsidern.

Il-metadati tad-dekoratur ibagħat ukoll id-dokumentazzjoni awtomatika ta' FastAPI, u jilibgaċ ir-rutti direttament mad-docs.

Hija l-ewwel u l-aktar fundamentali ħaġa li trid tgħallem f'FastAPI.