ルート（パス操作）はどのように定義しますか？

Question

Accepted Answer

FastAPIでは、**パス操作**はルート — HTTPメソッドデコレータ（`@app.get`、`@app.post`など）で装飾された関数で、パスへのリクエストを処理します。関数の戻り値は自動的にJSONにシリアライズされます。

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

各デコレータはHTTPメソッド+パスをハンドラにマッピングします。関数名はあなたのもの。デコレータがルートを定義します。戻されたdict/list/Pydanticモデルは自動的にJSONにシリアライズされます — 手動の`json.dumps`は不要です。

## 重複するパスの場合は順序が重要

```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はルートを宣言順に照合するため、静的パスを動的なもの前に配置します。

## オペレーションメタデータ（ドキュメントを駆動）

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

デコレータパラメータ（`tags`、`summary`、`status_code`、`response_model`）は動作を設定し、自動生成されたドキュメントを充実させます。

## なぜ重要なのか

パス操作はすべてのFastAPIアプリケーションの基礎です — APIのエンドポイントと、リクエストがどのように処理されるかを定義します。

デコレータ単位のHTTPメソッドパターン、戻り値が自動的にJSONにシリアライズされること（ボイラープレートなし）、パラメータの型ヒントが変換と検証を駆動すること、ルート順序が重複パスに対して重要であることを理解することは、あらゆるエンドポイントを構築するための毎日必須の知識です。

デコレータメタデータはFastAPIの自動ドキュメントにも供給され、ルートを直接ドキュメントに結びつけます。

これはFastAPIで習得する最初で最も基本的なことです。