Routes (path operations) ı nasıl tanımlarsınız?

Question

Accepted Answer

FastAPI'de, bir **path operation** bir route'dur — bir yola gelen istekleri işleyen bir HTTP method decorator'ü (`@app.get`, `@app.post` vb.) ile dekore edilmiş bir fonksiyondur. Fonksiyonun dönüş değeri otomatik olarak JSON'a serileştirilir.

## Her HTTP yöntemi için route'ları tanımlama

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

Her decorator, bir HTTP yöntemi + yolu bir handler'a eşler. Fonksiyon adı sizindir; decorator route'u tanımlar. Döndürülen dicts/listeler/Pydantic modelleri otomatik olarak JSON'a serileştirilir — manuel `json.dumps` gerekli değildir.

## Çakışan yollar için sıra önemlidir

```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, route'ları bildirme sırasına göre eşleştirir, bu nedenle statik yolları dinamik olanlardan önce yerleştirin.

## İşlem metadata'sı (docs'u yönlendirir)

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

Decorator parametreleri (`tags`, `summary`, `status_code`, `response_model`) davranışı yapılandırır ve otomatik olarak oluşturulan belgeleri zenginleştirir.

## Neden önemli

Path operations, her FastAPI uygulamasının temeli — API'nizin endpoint'lerini ve isteklerin nasıl işlendiğini tanımlarlar.

Decorator-per-HTTP-yöntemi deseni anlamak, dönüş değerlerinin otomatik olarak JSON'a serileştirildiğini (tekrarlayan kod yok), parametrelerdeki tür ipuçlarının dönüştürmeyi ve doğrulamayı yönlendirdiğini, ve rota sırasının çakışan yollar için önemli olduğunu, herhangi bir endpoint'i oluşturmak için günlük yaşamda gerekli bilgidir.

Decorator metadata'sı ayrıca FastAPI'nin otomatik belgelerini besler ve route'ları doğrudan docs'a bağlar.

Bu, FastAPI'de ustalaşılması gereken ilk ve en temel şeydir.