FastAPIハローワールドチュートリアル

1 FastAPIの紹介

FastAPIは、APIを構築するためのモダンなPython Webフレームワークです。WebレイヤーにはStarlette、データ検証にはPydanticを使用しています。型ヒントは単なる装飾ではなく、リクエストの解析、レスポンスのシリアライズ、自動ドキュメント化を推進します。

高速: NodeやGoに匹敵する高性能。
開発が高速: ボイラープレートコードを最小限に抑え、機能開発を加速。
バグが少ない: 入出力の検証を自動化。
標準ベース: OpenAPI、Swagger UI、ReDocを標準で生成。

準備ができたら、「次へ」をクリックしてください。ローカルで最小限のアプリを起動します。

2 前提条件：Python & Pip

Python 3.7+ と pip がインストールされていることを確認してください。

python --version
pip --version

python.org からインストールしてください。

3 仮想環境のセットアップ

仮想環境を使用して、依存関係を整理しましょう。

python -m venv .venv

アクティベートしてください:

# macOS/Linux
source .venv/bin/activate

# Windows (Command Prompt)
.venv\Scripts\activate

アクティブになると (.venv) が表示されます。

4 FastAPI と Uvicorn のインストール

仮想環境内に FastAPI と Uvicorn (ASGI サーバー) をインストールしてください。

pip install "fastapi[all]" uvicorn[standard]

[all] は Pydantic v2 および標準のオプション依存関係をプルします。軽量なインストールを好む場合は、pip install fastapi uvicorn を使用してください。

5 main.py の作成

main.py という名前のファイルを作成し、基本的なエンドポイントを追加してください。

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
    return {"message": "Hello, FastAPI"}

これだけで、1つのインポート、1つのアプリ、1つのルートが作成されます。docstring と型ヒントは、生成されるドキュメントを強化します。

6 Uvicorn でサーバーを実行

開発中はホットリロードでサーバーを起動してください。

uvicorn main:app --reload

http://127.0.0.1:8000/ を開いて JSON レスポンスを確認してください。

7 インタラクティブドキュメントの探索

FastAPI は Swagger UI と ReDoc を自動的に提供します。

Swagger UI: /docs
ReDoc: /redoc
OpenAPI スキーマ: /openapi.json

追加の設定なしで、ドキュメントから直接エンドポイントを試したり、リクエスト/レスポンスモデルを確認したりできます。

8 パスパラメータを持つルートの追加

main.py をパラメータ化されたルートで更新してください。

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
    return {"message": "Hello, FastAPI"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
    result = {"item_id": item_id}
    if q:
        result["q"] = q
    return result

型ヒントのおかげで、item_id は整数として検証され、自動的にドキュメント化されます。

9 リクエストボディの受け入れ (Pydantic)

モデルを定義し、JSONペイロードを受け入れてください。

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()


class Item(BaseModel):
    name: str
    price: float
    tags: list[str] = []


@app.post("/items/", response_model=Item)
def create_item(item: Item):
    # 通常はこれを保存しますが、ここではエコーバックします。
    return item


@app.get("/")
def read_root():
    return {"message": "Hello, FastAPI"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
    result = {"item_id": item_id}
    if q:
        result["q"] = q
    return result

FastAPI は JSON を検証し、型を強制し、生成されるスキーマにモデルをドキュメント化します。

10 エラーの発生と処理

クリーンなエラーレスポンスには HTTPException を使用してください。

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel

app = FastAPI()


class Item(BaseModel):
    name: str
    price: float
    tags: list[str] = []


db: dict[int, Item] = {}


@app.post("/items/", response_model=Item)
def create_item(item: Item):
    new_id = len(db) + 1
    db[new_id] = item
    return item


@app.get("/items/{item_id}")
def read_item(item_id: int):
    item = db.get(item_id)
    if not item:
        raise HTTPException(status_code=404, detail="Item not found")
    return {"item_id": item_id, **item.dict()}

存在しない ID を試すと、クリーンな 404 JSON: {"detail": "Item not found"} が返されます。

11 次のステップとデプロイ

依存関係の固定: pip freeze > requirements.txt
本番モードの試行: uvicorn main:app --host 0.0.0.0 --port 8000
Render, Fly.io, Railway, または Gunicorn + Uvicorn ワーカーを備えた VM にデプロイ
エラーフォーマットの一元化には @app.exception_handler を使用
fastapi.security を介した OAuth2/JWT でエンドポイントを保護

これで、動作する API、検証、ライブドキュメントが完成しました。ここから、フレームワークを切り替えることなく、ルート、レイヤー、テストを拡張できます。