本章の概要

この章では、FastAPIのAPIサーバに対してブラウザからのCORSエラーを体験しつつ、CORSMiddlewareで解消する方法をハンズオン形式で学習しながら実装します。これにより、CORSの仕組みを理解した上で、ブラウザからのクロスオリジン呼び出しを許可するAPIサーバが構築できるようになります。

1. 本章の目的

前章 PythonでREST APIを作ろう までで、FastAPIとSQLModelを組み合わせたREST APIをcurlから呼び出せるところまで確認しました。実際のアプリケーションでは、ブラウザで開いた画面からAPIを呼び出す場面が中心になります。このときブラウザは、異なるオリジン(プロトコル・ホスト・ポートの組み合わせ)へのリクエストに対してCORS(Cross-Origin Resource Sharing)と呼ばれる仕組みで通信可否を判定するため、API側で明示的に許可設定を返さないと画面からの呼び出しが失敗します。本章では、CORSエラーを実際に画面から発生させたうえで、FastAPIのCORSMiddlewareで解消し、単純リクエストとプリフライトリクエストの両方の挙動を確認します。

2. ハンズオンの流れ

APIサーバと、それを呼び出す画面(静的HTMLを配信するフロントエンド用サーバ)の2つを立ち上げ、ブラウザからAPIを呼び出したときにCORSエラーが発生することを確認します。そのうえで、FastAPIのCORSMiddlewareを組み込んでエラーを解消します。

3. 事前準備

3.1 必要なツール

この章では、以下のツールを使用します。まだインストールしていない場合は、リンク先の手順に沿って準備をお願いします。

ツール名 関連箇所 理由
Visual Studio Code Visual Studio Codeのインストール APIサーバ・フロントエンドのコードを記述するエディタとして使用する
Python Pythonのインストール APIサーバ・フロントエンド用サーバの実行環境として使用する
Webブラウザ – CORSエラーとその解消を確認する画面として使用する(Google Chromeなど)