PR：この記事にはアフィリエイトリンクが含まれます。
ここではPythonの基礎がある人に向けて、FastAPIでAPIを作る際に迷いやすい設計上の境界を整理します。各書籍の刊行情報と学べる工程も一覧にしました。気になるテーマを見つけやすいはずです。
FastAPIの実務
FastAPIはPythonの型ヒントを活かし、ルート定義やデータ検証をすっきり書けます。始めやすいのは魅力。ただし仕事で大切なのは、コードの短さより変更しやすい境界の設計です。
タスク管理APIを例にすると、/tasksで一覧や新規作成を扱い、/tasks/{task_id}で個別の取得・更新・削除を行います。画面の構成ではなく、扱う対象をURLの中心に置くと役割が伝わります。
API開発はルート関数だけでは終わりません。リクエストを検証し、権限や業務ルールを確かめてDBへ保存し、利用者に必要な形で返します。ここまで含めてAPI開発です。
まず正常系を動かしたら、入力ミスや対象データがない場合も試してみましょう。失敗時の応答を決めておくと、APIを使う側も原因を追いやすいですね。
早見表
各書籍が扱う工程を一覧にしました。REST APIの基本から認証や非同期処理、クラウド公開まで、学習範囲の目安をつかめます。
| 書籍 | 刊行情報 | 主な範囲 |
|---|---|---|
 Python Web開発実践入門 ―― FastAPIによるWeb API開発と非同期処理 | 技術評論社・2026年8月13日、A5判344ページ | Pydantic、SQLAlchemy・Alembic、pytest、Cloud Run・Cloud SQL |
 動かして学ぶ！Python FastAPI開発入門 | 翔泳社・2023年6月14日、A5判296ページ | ToDo API、MySQL、非同期CRUD、テスト、クラウド公開 |
 Python FastAPI本格入門 | 技術評論社・2024年10月26日、B5判256ページ | RESTの基礎、Pydantic、SQLite・SQLAlchemy、DI |
 FastAPI Cookbook: Develop high-performance APIs and web applications with Python | Packt・2024年8月、英語・358ページ | 認証、SQL・NoSQL、テスト、デプロイ |
 High-Performance Web Apps with FastAPI: The Asynchronous Web Framework Based on Modern Python | Apress・2023年、英語・309ページ | 非同期DB接続、セキュリティ、テスト、Docker公開 |
和書3冊の参考価格は税込3,300〜3,520円です。『Python Web開発実践入門』と『動かして学ぶ！Python FastAPI開発入門』は3,520円、『Python FastAPI本格入門』は3,300円。いずれも税込定価を参考価格とし、実売価格は時期や店舗で変わります。
和書はRESTの基本からDB、テスト、デプロイへと進みます。英語の2冊では認証・認可や複数種のDB、非同期処理まで扱います。
REST APIの設計
URLは名詞でリソースを表し、HTTPメソッドで操作を示します。一覧ならGET /tasks、作成はPOST /tasks、一件の更新はPATCH /tasks/{task_id}。役割を分けるのが基本です。
作成が成功したら201 Created、対象がなければ404 Not Foundなど、処理結果に合ったステータスコードを返します。エラー本文も一定の形式に揃えると、クライアント側で表示や再試行を組み立てやすくなります。
検索条件やページ送りも、早めにルールを決めておきたいところです。limitに加えて並び順や次ページの決め方まで揃えれば、データが増えても一覧APIを保ちやすいでしょう。
公開後にレスポンスの形を変えると、利用中のクライアントに影響する場合があります。互換性のある項目追加と互換性を壊す変更は分けて考えましょう。必要ならAPIのバージョン管理も検討します。
入力とDB設計
Pydanticのスキーマは、外部から受け取る値を検証する境界です。作成時や更新時、レスポンス用のスキーマを分けておけば、DBの内部項目やパスワードのハッシュを不用意に返す事故を防ぎやすくなります。
SQLAlchemyのモデルはDBの構造を表し、APIスキーマは外部との約束を表します。両者を同じものとして扱うと、DBの都合がAPIに漏れたり、レスポンスの変更に困ったりすることがあります。
DBの列を変えるときは、Alembicなどで変更履歴を管理します。手元のDBだけを直接直すと開発環境と本番環境の状態がずれがちです。変更を再現できるマイグレーションが役立ちます。
非同期処理も万能ではありません。DBドライバーや呼び出す処理が非同期に対応し、待ち時間の大きい入出力がある場合に効果を検討します。同期処理が混ざれば、性能改善も限定的です。
テストと公開
pytestでは、APIの応答コードだけでなく、保存後のデータやエラー時の形式も確かめます。FastAPIのテストクライアントを使えば、HTTPリクエストを通した動きをアプリ内で確認できます。
テスト用DBは本番データと分け、テストごとに初期化できる状態にします。既存データに頼るテストは、実行順や環境で結果が変わりがち。原因調査にも手間がかかります。
不足した入力や存在しないID、重複登録、認証不足もテストします。正常なときに返るJSONだけでなく、利用者が遭遇する失敗も試すとAPIの契約が具体的になります。
公開時には環境変数やシークレットで接続情報を管理し、DBの接続数や起動時のマイグレーション手順も確認します。ログやヘルスチェック、認証設定まで整えて、運用中の状態を追えるようにしましょう。
日本語書籍3冊
日本語の3冊は、APIの基本から開発工程全体まで、それぞれ異なる範囲を扱います。RESTの概念を固める内容から、テストやデプロイまで追う内容まで揃っています。
陶山嶺著の『Python Web開発実践入門』は、Pydanticの概要とカスタマイズを扱い、SQLAlchemy・Alembicやpytestとテスト用DBへ進みます。Cloud RunとCloud SQLへのデプロイも含むので、Python基礎がある人がAPI開発を順に追えます。
中村翔著の『動かして学ぶ！Python FastAPI開発入門』はToDoアプリが題材で、REST APIやルーター、入出力スキーマを実装します。Docker・MySQL・SQLAlchemyのCRUDとaiomysqlの非同期DB操作に加え、テストからAWS App RunnerまたはCloud Runへのデプロイまで扱います。
樹下雅章著の『Python FastAPI本格入門』は、RESTの原則、HTTPメソッド、CRUDからPydantic、SQLite・SQLAlchemy、DIへ進みます。後半はスキーマ駆動のAPIサービス作成。基礎をコードに結びつけたい入門者になじみやすい流れです。
英語書籍2冊
英語の2冊は基本CRUDに加え、認証・非同期処理・運用まで扱います。英語の技術用語にも慣れたい人には、用語と実装を同時に追えるのが利点ですね。
Giunio De Luca著の『FastAPI Cookbook』は英語のレシピ形式。RESTful CRUDやAPIバージョニングに加え、OAuth2・JWTやRBAC、多要素認証、APIキーとセッションCookieを扱います。SQLAlchemy・MongoDB、テスト、本番デプロイも範囲です。
Malhar Lathkar著の『High-Performance Web Apps with FastAPI』は、Pydanticモデルによる入出力定義とリレーショナルDB・NoSQL DBへの非同期接続を扱います。セキュリティやテスト、Deta・Dockerでの公開も含む英語本です。非同期DB接続を中心に学びたい人に合います。
High-Performance Web Apps with FastAPI: The Asynchronous Web Framework Based on Modern Python
Apress
Amazonで見る結論
RESTの基本から始めるなら、『Python FastAPI本格入門』がおすすめです。HTTPメソッドやCRUD、Pydantic、SQLiteを順に押さえられます。Pythonの基礎があるFastAPI初学者にも読み進めやすい内容です。
『Python Web開発実践入門』はDBのスキーマ変更からテスト、クラウド公開まで学びたい人におすすめです。 Alembicやテスト用DBに加え、Cloud RunとCloud SQLへのデプロイも扱います。
DockerとMySQLでToDo APIを組み、非同期CRUDまで実装したい人には、『動かして学ぶ！Python FastAPI開発入門』がおすすめです。認証・認可は『FastAPI Cookbook』、非同期DB接続は『High-Performance Web Apps with FastAPI』で掘り下げられます。
Amazon の PC をスコア化してみた
Amazonにある8〜14インチの小型WindowsタブレットやノートPCを、スペック別にスコア化して比較・ランキング。
