Hogyan határozza meg az útvonalakat (path operations)?

Question

Accepted Answer

A FastAPI-ban egy **path operation** egy útvonal — egy HTTP metódus dekorátorral (`@app.get`, `@app.post` stb.) díszített függvény, amely egy útvonalra érkező kéréseket kezeli. A függvény visszatérési értéke automatikusan JSON-ba szerializálódik.

## Útvonalak meghatározása az egyes HTTP módszerekhez

```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}
```

Minden dekorátor egy HTTP metódust + útvonalat leképez egy kezelőre. A függvény neve az öné; a dekorátor definiálja az útvonalat. A visszaadott dicts/listák/Pydantic modellek automatikusan JSON-ba szerializálódnak — nincs manuális `json.dumps`.

## A sorrend számít az átfedő útvonalak esetén

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

A FastAPI az útvonalakat a deklaráció sorrendjében illeszti, ezért helyezze a statikus útvonalakat a dinamikus elé.

## Műveleti metaadatok (táplálják a dokumentációt)

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

A dekorátor paraméterei (`tags`, `summary`, `status_code`, `response_model`) konfigurálják a viselkedést és gazdagítják az automatikusan generált dokumentációt.

## Miért fontos

A path operations minden FastAPI alkalmazás alapja — meghatározzák az API végpontjait és a kérések kezelésének módját.

A dekorátor-HTTP-módszer minta megértése, hogy a visszatérési értékek automatikusan JSON-ba szerializálódnak (nincs boilerplate), hogy a paraméterek típusjelzése vezérli az átalakítást és az érvényesítést, valamint az útvonal sorrendje az átfedő útvonalak esetén fontos, ez az alapvető napi tudás az alkalmazások bármely végpontjának felépítéséhez.

A dekorátor metaadatai szintén táplálják a FastAPI automatikus dokumentációját, közvetlenül az útvonalakat a dokumentációhoz kapcsolva.

Ez az első és legalapvetőbb dolog, amit a FastAPI-ban meg kell tanulni.