【FastAPI初級】80分で習得する直感的なWeb API開発が可能な新しいPython WebフレームワークFastAPIの基礎

FastAPIは、PythonでWeb APIを簡単に開発するためのモダンなフレームワークです。FastAPIは、高速で直感的に開発を行うことができ、静的型付けと自動型推論をサポートしており、安全なAPIを構築する際に非常に便利です。今回は、FastAPIの基礎を80分で学ぶチュートリアルを提供します。

1. FastAPIのインストール
   まずは、FastAPIをインストールします。以下のコマンドを実行して、FastAPIをインストールします。

pip install fastapi

1. uvicornのインストール
   次に、FastAPIを実行するために、uvicornというASGIサーバーをインストールします。以下のコマンドを実行して、uvicornをインストールします。

pip install uvicorn

1. FastAPIアプリケーションの作成
   FastAPIのアプリケーションを作成するために、以下のコードを含むmain.pyファイルを作成します。

from fastapi import FastAPI

app = FastAPI()

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

1. FastAPIアプリケーションの実行
   以下のコマンドを使用して、uvicornを使用してFastAPIアプリケーションを実行します。

uvicorn main:app --reload

このコマンドを実行すると、FastAPIアプリケーションが起動し、http://127.0.0.1:8000/ でアクセスできるようになります。ブラウザでこのURLにアクセスすると、{"Hello": "World"}というレスポンスが表示されます。

1. パスとパラメータの追加
   FastAPIでは、ルーティングやパラメータの受け取りが簡単に行えます。以下のコードをmain.pyに追加して、パスとパラメータを処理できるようにします。

@app.get("/items/{item_id}")
async def read_item(item_id: int, q: str = None):
    return {"item_id": item_id, "q": q}

このコードでは、/items/{item_id}というパスで、item_idとqというパラメータを受け取り、それをそのまま返す処理を行っています。アプリケーションを再起動することで、新しいエンドポイントが追加されます。

1. リクエストボディの処理
   FastAPIでは、リクエストボディの処理も簡単に行うことができます。以下のコードをmain.pyに追加して、リクエストボディを受け取る処理を追加します。

from pydantic import BaseModel

class Item(BaseModel):
    name: str
    description: str = None
    price: float
    tax: float = None

@app.post("/items/")
async def create_item(item: Item):
    return item

このコードでは、ItemというPydanticモデルを定義し、 /items/ というパスでPOSTメソッドを受け付け、Itemモデルのデータを受け取ってそのまま返す処理を行っています。

1. ドキュメントの自動生成
   FastAPIは、自動的にSwagger UIを生成してAPIのドキュメントを表示することができます。http://127.0.0.1:8000/docs にアクセスすると、自動生成されたAPIのドキュメントが表示されます。

以上が、FastAPIの基礎を80分でマスターするためのチュートリアルです。FastAPIを使用することで、PythonでのWeb API開発が簡単に行えるようになりますので、ぜひ活用してみてください。