読み方のヒント

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

第5節 DBの失敗をAPIへ返す

5.1 失敗の種類と応答

データベースに接続できないとき、何もしなければ 500 が返ります。接続の失敗を表す OperationalError を受け止めて、503 を返すようにします。

@app.exception_handler(OperationalError)
def database_unavailable(request: Request, exc: OperationalError):
    return JSONResponse(
        status_code=503,
        content={"detail": {"code": "database_unavailable",
                            "message": "ただいま予約を受け付けられません。時間をおいてお試しください"}},
    )

@app.exception_handler(例外の種類) は、どの関数の中でその例外が起きても、ここで受け止めて応答を作る指定です。503 Service Unavailable は、一時的に処理できないことを表します。

この章のAPIが返す失敗を、まとめます。

状態コードcode原因送り直してよいか
422項目のリスト、または店の規則の code入力の誤り、規則の違反直してから送る
404reservation_not_found予約がない、自分の予約でない送り直しても同じ
409idempotency_key_reused同じキーで違う内容新しいキーで送る
409status_conflict予約の状態が変わっていた予約を読み直す
503database_unavailableデータベースに接続できない時間をおいて同じキーで送る

18 / 20