- FastAPIって何がうれしいの？
- Djangoとどう違うのか、どっちを使えばいいのかわからない
- ライブラリの組み合わせが多くて、環境構築でつまずきそう
このような疑問にお答えします。
FastAPIは、Pythonで書けるAPI特化のWebフレームワークです。型ヒントをベースにしたバリデーションと、自動生成されるAPIドキュメントが特徴です。
このガイドでは、FastAPIの基本的な考え方から、実際にAPIを1つ動かすところまでを解説します。後半には関連記事へのロードマップも用意しています。
FastAPIとは何か
FastAPIは、Pythonの型ヒントを使ってAPIのリクエスト・レスポンスを定義するWebフレームワークです。型ヒントを書くだけで、リクエストデータのバリデーションと、Swagger UIによる対話的なAPIドキュメントが自動生成されます。
DjangoがWebアプリ全般を想定した「フルスタック」寄りのフレームワークなのに対し、FastAPIはAPIサーバーに機能を絞っています。管理画面やテンプレートエンジンは標準では付いてきません。
正直、僕はFastAPIを自分から選ぶことはあまりない
正直に言うと、僕は普段からFastAPIを積極的に選ぶタイプではありません。案件やプロジェクトで既にFastAPIが採用されていて、それに対応する形で触ることがほとんどです。
とはいえ、慣れてしまえば身構えるほどのフレームワークでもありません。このガイドは「自分から選んで学ぶ人」よりも、「必要になったから触ることになった人」を想定して書いています。
FastAPIを始める前に知っておきたいこと
FastAPI自体はシンプルですが、実際に動かすにはUvicorn（ASGIサーバー）やPydantic（データ検証）など、いくつかのライブラリを組み合わせる必要があります。
ここが最初につまずきやすいポイントです。僕自身、Djangoのように機能がひとつにまとまっている感覚でいたので、複数のライブラリの依存関係やバージョンの組み合わせを自分で把握する必要がある点の取り回しに、最初は戸惑いました。
ただ、これは裏を返せば「必要なものだけ組み合わせられる」ということでもあります。最初の環境構築さえ乗り切れば、あとの学習コストはそこまで高くありません。
はじめてのAPIを書いてみよう
理屈より先に、実際に動くAPIを見てみましょう。GETリクエストを受けてJSONを返す、最小構成の例です。
from fastapi import FastAPI
app = FastAPI()
@app.get("/hello")
def hello():
return {"message": "Hello, FastAPI!"}@app.get("/hello")のようにデコレータでパスとHTTPメソッドを指定するだけで、ルーティングが完成します。関数の戻り値をそのままJSONとして返してくれるので、レスポンスの組み立てで悩むこともありません。
関連記事
基本が掴めたら、以下の記事でさらに実践的な使い方を解説しています。モデル設計・DB連携・認証・デプロイ編は現在準備中です。
まとめ
FastAPIは、型ヒントベースのバリデーションと自動ドキュメント生成が武器のAPIフレームワークです。このガイドで押さえておきたい点は次のとおりです。
- FastAPIはAPIに特化した軽量フレームワーク。Djangoほどオールインワンではない
- 最初のハードルはライブラリの組み合わせ・依存関係の把握
- ルーティングはデコレータで書き、戻り値がそのままJSONになる
依存関係さえ乗り越えれば、FastAPIは実は簡単です。プロジェクトで必要になったタイミングで、気負わず触ってみてください。
コメント