Path Operationの設定

path operationデコレータを設定するためのパラメータがいくつかあります。

/// warning | "注意"

これらのパラメータはpath operation関数ではなく、path operationデコレータに直接渡されることに注意してください。

///

レスポンスステータスコード

path operationのレスポンスで使用する（HTTP）status_codeを定義することができます。

404のようにintのコードを直接渡すことができます。

しかし、それぞれの番号コードが何のためのものか覚えていない場合は、statusのショートカット定数を使用することができます:

{!../../docs_src/path_operation_configuration/tutorial001.py!}

そのステータスコードはレスポンスで使用され、OpenAPIスキーマに追加されます。

/// note | "技術詳細"

また、from starlette import statusを使用することもできます。

FastAPI は開発者の利便性を考慮して、fastapi.statusと同じstarlette.statusを提供しています。しかし、これはStarletteから直接提供されています。

///

summaryとdescriptionを追加できます:

{!../../docs_src/path_operation_configuration/tutorial003.py!}

説明文は長くて複数行におよぶ傾向があるので、関数docstring内にpath operationの説明文を宣言できます。すると、FastAPI は説明文を読み込んでくれます。

docstringにMarkdownを記述すれば、正しく解釈されて表示されます。（docstringのインデントを考慮して）

{!../../docs_src/path_operation_configuration/tutorial004.py!}

これは対話的ドキュメントで使用されます:

response_descriptionパラメータでレスポンスの説明をすることができます。

{!../../docs_src/path_operation_configuration/tutorial005.py!}

/// info | "情報"

respnse_descriptionは具体的にレスポンスを参照し、descriptionはpath operation全般を参照していることに注意してください。

///

/// check | "確認"

OpenAPIはpath operationごとにレスポンスの説明を必要としています。

そのため、それを提供しない場合は、FastAPI が自動的に「成功のレスポンス」を生成します。

///

path operationをdeprecatedとしてマークする必要があるが、それを削除しない場合は、deprecatedパラメータを渡します:

{!../../docs_src/path_operation_configuration/tutorial006.py!}

対話的ドキュメントでは非推奨と明記されます:

path operationsが非推奨である場合とそうでない場合でどのように見えるかを確認してください:

path operationデコレータにパラメータを渡すことで、path operationsのメタデータを簡単に設定・追加することができます。