PythonのRESTfulフレームワーク FastAPI入門

PythonでWebアプリケーションのバックエンドを開発することになった際、技術選定で選択肢に上がる可能性が高いFastAPIについて紹介します。
フロントエンドにReact.jsやVue.jsを選択した場合、REST APIをバックエンドに立てる機会は多いです。FastAPIを使えば、学習コストを抑えめにしつつ、高速な開発が可能となります。

FastAPIとは

FastAPIは、Python 3.7以上でAPIを構築するための高性能なWebアプリケーションフレームワークです。開発者が迅速かつ効率的にREST APIアプリケーションを構築するのに役立ちます。

FastAPIはStarletteのWebサーバー上に構築され、自動データ検証、エラー処理、そして対話型APIドキュメントなど、Webアプリケーションの構築を容易にする機能を備えています。

FastAPIを選ぶ理由

エンジニアがFastAPIを選ぶべき理由は以下の通りです。

これらの特徴は、Starletteフレームワーク上に構築されていることによる恩恵が多分に含まれています。データ検証部分はPydanticです。
こういった巨人の肩に乗ることで、async/awaitの予約語使用によって非同期コードをサポートしていたり、APIリクエストとレスポンスの高速で効率的な検証などが備わっています。

FlaskやDjangoのような他の主要なPythonフレームワークと比較すると実に高速です。

さらに、型ヒントを使用してAPIリクエストとレスポンスを自動的に検証し、JSONとの間でデータを自動的にシリアライズおよびデシリアライズするため、定型的なコードを排除します。
また、シンプルで直感的なAPIが付属しており、学習・使用が簡単です。

FastAPIのパフォーマンス

FastAPIはその高いパフォーマンスで知られています。
TechEmpowerというWebアプリケーションフレームワークのベンチマークを提供しているWebサイトを参考にしてみましょう。Uvicornの下で動作するFastAPIアプリケーションは、利用可能なPythonフレームワークの中で高速なものの1つであることがわかります。

ここでFastAPIの説明に不可欠なUvicornやStarletteについて説明しておきます。

FastAPIは優れたパフォーマンスを提供する一方で、データ検証やシリアライゼーションなど、APIを構築する際に有益な多くの機能も提供していることが大きなメリットです。
したがって、FastAPIを使用することで開発時間やコード量が節約でき、より速いフレームワークで構築するよりも高い開発体験が得られます。

FastAPIと他のPythonフレームワークの比較

以下はFastAPIと代表的なPython製Webアプリケーションフレームワークの比較です。FastAPIの紹介記事なので、比較項目がややFastAPI寄りとなっていることをご留意ください。

FastAPI 用の開発環境のセットアップ

入門用に、FastAPIの開発を開始する手順を紹介していきます。

uvicornとfastapiをインストールします。
pipがすでにインストールされている前提で話を進めます。

ターミナルを開き、以下のコマンドを実行しましょう。

pip install uvicorn fastapi

最初の FastAPI アプリケーションの作成

簡単なFastAPIアプリケーションを作成していきましょう。
まずはmain.pyを作成します。

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
async def root():
    return {"message": "Hello World"}

この時点で最初のアプリケーション自体は完成です。とても簡単ですね。
このアプリケーションは、ASGIサーバーであるUvicornを使って以下のコマンドを使って実行できます。

uvicorn main:app --reload

uvicorn main:app --reloadコマンドでは、mainはmain.pyファイル（Pythonのモジュールに該当）を指し、appはapp = FastAPI()というオブジェクトです。--reloadフラグは、コード変更後にサーバーを再起動（ホットリロード）させます。

アプリが実行されると、http://localhost:8000でブラウザを開き、JSONレスポンスを確認できます。また、http://localhost:8000/docsで自動生成されたAPIドキュメントを、http://localhost:8000/redocでReDocという別の自動生成APIドキュメントを参照できます。

FastAPIは、APIを定義するためのOpenAPIを使用して、すべてのAPIを含む「スキーマ（構造）」を生成します。このスキーマ定義には、APIパス、APIが受け取る可能性のあるパラメータなどが含まれます。
生のOpenAPIスキーマはhttp://localhost:8000/openapi.jsonで確認できます。

FastAPIのルーティングとエンドポイント処理

FastAPIのルーティングとエンドポイント処理は、このフレームワークの重要な機能です。

ルーティング

FastAPIはデコレーターを使ってルートを定義します。
ルートとは、アプリケーションが公開するエンドポイント（エンドユーザーがアクセスできるURL定義）です。例えば、ルート（"/"）でHTTP GETリクエストを処理するルートを次のように定義できます。

@app.get("/")
async def root()：
    return {"message"： "Hello World"}

@app.get("/")デコレーターは、以下の関数がパス"/"に対応し、GETリクエストを処理するために使用されるべきであることをFastAPIに伝えます。

エンドポイント処理

リクエストが来ると、FastAPIはルートとHTTPメソッド（GET、POSTなど） に従って処理します。デコレーターの下の関数(上の例で書いたroot()など)が呼び出され、リクエストを処理し、レスポンスを生成します。

FastAPI の依存性注入システムの活用

FastAPIには、強力で直感的な依存性注入システム（DIとも言います）があります。その仕組みは以下の通りです。

以下、Dependsを使った依存性注入定義の例です。common_parametersに依存性を持たせることで、read_items()にcommon_parametersの特性を持たせます。

@app.get("/items/")
async def read_items(commons: Annotated[dict, Depends(common_parameters)]):
    return commons

Pydantic と FastAPI によるデータの検証

Pydanticは強力なデータ検証機能を提供するPythonライブラリで、FastAPIをインストールすると自動的にインストールされます。
FastAPIにおいて、Pydanticは以下のような役割を持っています。

FastAPIの自動バリデーションとエラー処理により、繰り返しバリデーションコードを書く必要がなくなります。

FastAPIの将来性

FastAPIは今でも積極的に開発が進められており、2023年7月にPydantic2へ対応する大型アップデートをしたばかりです。
年々、フロントエンドとバックエンドの開発分離が一般的になってから、より需要が高まっているため、今後もPythonにおけるREST APIフレームワークとしてスタンダードの座を守り続けるでしょう。

Python開発者にとって、手軽に外部APIを開発できるスキルは必須となるので、FastAPIを使いこなせると幅が広がります。Pydanticや認証周り、データベース操作を含めると難易度は上がりますが、ぜひ習得してみてください。