読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第3節 ログイン要求

3.1 POST /auth/token

auth.py にログインのAPIを書きます。

from fastapi.security import OAuth2PasswordRequestForm

router = APIRouter()


@router.post("/auth/token", response_model=TokenOut)
def login(form: Annotated[OAuth2PasswordRequestForm, Depends()], session: SessionDep):
    user = session.scalar(select(User).where(User.username == form.username))
    if user is None or user.password_hash is None or not verify_password(form.password, user.password_hash):
        logger.info("login failed: username=%s", form.username)
        raise unauthorized("ユーザー名かパスワードが違います")
    logger.info("login succeeded: user_id=%s", user.id)
    return {"access_token": create_access_token(user.id), "token_type": "bearer"}

OAuth2PasswordRequestForm は、username と password を、フォームの形式で受け取るためのクラスです。フォームの形式は、username=tanaka&password=tanaka-renshu のように、名前と値を & でつないだ書き方です。JSONで送ると、422 で断られます。

APIRouter は、APIをファイルごとに分けて登録するための部品です。main.py で app.include_router(router) と書くと、auth.py のAPIが加わります。

/docs を開くと、右上に「Authorize」のボタンが現れます。ユーザー名とパスワードを入れると、/docs がログインのAPIを呼び、以後の要求に印を付けて送ってくれます。

10 / 20