最初のゴール：りんご200円を登録して取り出す

Pythonの関数と辞書を少し知っている人向けです。今回作るのは、自分の端末のメモリへ商品を保存するAPIです。データベースやログインは次の段階で加えます。

操作	窓口	成功の目印
登録	POST /products	201と商品ID
一覧	GET /products	200と商品の配列
1件取得	GET /products/ID	200と商品1件

PythonとFastAPIを準備する

Python 3.10以上の対応環境を使います。新しいapi-shoppingフォルダーへ移動し、仮想環境を作ります。

python -m venv .venv

WindowsのPowerShellでは次を実行します。

.venv\Scripts\python -m pip install "fastapi[standard]"

macOS・Linuxでは.venv/bin/python -m pip install "fastapi[standard]"です。環境のPythonコマンドがpython3の場合は仮想環境の作成時も読み替えてください。

main.pyに窓口を作る

フォルダー直下にmain.pyを作ります。この例は単一プロセスのメモリに保存する学習用です。

from uuid import uuid4
from fastapi import (
    FastAPI, HTTPException
)
from pydantic import BaseModel, Field

app = FastAPI()
products = {}

class ProductInput(BaseModel):
    name: str = Field(
        min_length=1, max_length=80
    )
    price: int = Field(gt=0, strict=True)

@app.post('/products', status_code=201)
def create_product(product: ProductInput):
    product_id = str(uuid4())
    saved = {
        'id': product_id,
        **product.model_dump()
    }
    products[product_id] = saved
    return saved

@app.get('/products')
def list_products():
    return list(products.values())

@app.get('/products/{product_id}')
def get_product(product_id: str):
    if product_id not in products:
        raise HTTPException(
            404, 'Product not found'
        )
    return products[product_id]

Windowsでは同じフォルダーで起動します。

.venv\Scripts\python -m uvicorn main:app --reload --host 127.0.0.1

macOS・Linuxは先頭を.venv/bin/pythonに変えます。main:appはmain.pyのappを指します。--reloadは開発中の再起動用です。

Swagger UIで成功と失敗を確かめる

ブラウザーでhttp://127.0.0.1:8000/docsを開きます。

1. POST /productsを開き、Try it outを押します。
2. 入力を次のJSONにし、Executeで送ります。
3. 201と返ってきたidを確認します。
4. GET /productsを実行し、りんご200円が一覧にあるかを確かめます。

{
  "name": "りんご",
  "price": 200
}

次に、priceを0にして登録し、422と入力の説明が返るかを見ます。GET /products/{product_id}へmissingを入れると404です。正常な商品IDを入れれば200になります。これで正常系だけでなく、二つの失敗も確認できます。

うまくいかない場面	見直すところ
/docsが開かない	サーバーが起動しているか、ポートが同じか
mainが見つからない	main.pyと同じフォルダーで起動したか
登録した商品が消えた	再起動が起きたか。今回はメモリ保存

本番へ進むときに加えるもの

この例には認証・権限の制御や永続的な保存がありません。名前の検査も文字数の例で、業務上有効な商品名の判断まで担いません。

公開時はDBへ保存し、誰がどの商品を操作できるかを確認します。HTTPS、入力の業務ルール、負荷制御、ログ、障害対応も必要です。JWTは選択肢の一つで、入力検証や権限確認の代わりではありません。URLにv1を付けるだけでも、既存利用者への影響が自動でなくなるわけではありません。

学習を終えたら端末でCtrl+Cを押し、自分のサーバーを止めます。

次に学ぶなら

MongoDB入門やNeon入門で保存先を学び、GraphQL入門で別の窓口の設計と比べてみましょう。

参考資料

• FastAPI Request body — JSON入力のモデルと検証
• FastAPI Fields — 値の範囲の指定
• FastAPI Response status — 201の指定と仕様への反映
• FastAPI Handling errors — HTTPExceptionと404