読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
データベースに接続できないとき、何もしなければ 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 | 入力の誤り、規則の違反 | 直してから送る |
404 | reservation_not_found | 予約がない、自分の予約でない | 送り直しても同じ |
409 | idempotency_key_reused | 同じキーで違う内容 | 新しいキーで送る |
409 | status_conflict | 予約の状態が変わっていた | 予約を読み直す |
503 | database_unavailable | データベースに接続できない | 時間をおいて同じキーで送る |
18 / 20