## Documentation Deprecate a *Path Operation* - OpenAPI { #documentation-deprecate-a-path-operation-openapi }

To deprecate a *path operation*, and show it in the docs UI, read the docs for [Tutorial - Path Operation Configurations - Deprecation](../tutorial/path-operation-configuration.md#deprecate-a-path-operation).

## Deprecate a *path operation* { #deprecate-a-path-operation }

If you need to mark a *path operation* as <dfn title="obsolete, recommended not to use it">deprecated</dfn>, but without removing it, pass the parameter `deprecated`:

{* ../../docs_src/path_operation_configuration/tutorial006_py310.py hl[16] *}

It will be clearly marked as deprecated in the interactive docs:

## *Path Operation* の非推奨化 - OpenAPI { #documentation-deprecate-a-path-operation-openapi }

*path operation* を非推奨にし、ドキュメント UI に表示するには、[チュートリアル - path operation の設定 - 非推奨](../tutorial/path-operation-configuration.md#deprecate-a-path-operation) を参照してください。

## 任意のデータを JSON 互換に変換 { #convert-any-data-to-json-compatible }

## Important Notes

1. Always run `mvn test` after changes
2. Run `mvn formatter:format` before committing
3. Add license headers to new files with `mvn license:format`
4. Maintain backwards compatibility - deprecate before removing

- the `Request`: `Request` (keep as code identifier)
- the `Response`: `Response` (keep as code identifier)

- deployment: déploiement
- to upgrade: mettre à niveau

- deprecated: déprécié
- to deprecate: déprécier

- cheat sheet: aide-mémoire

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

///

<img src="/img/tutorial/path-operation-configuration/image03.png">

## *path operation*を非推奨にする { #deprecate-a-path-operation }

*path operation*を<dfn title="非推奨、使用しないことを推奨">deprecated</dfn>としてマークする必要があるが、それを削除しない場合は、`deprecated`パラメータを渡します:

{* ../../docs_src/path_operation_configuration/tutorial006_py310.py hl[16] *}

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

因此，如果你未提供，**FastAPI** 會自動產生 "Successful response"。

///

<img src="/img/tutorial/path-operation-configuration/image03.png">

## 將「路徑操作」標記為已棄用 { #deprecate-a-path-operation }

若需要將「路徑操作」標記為 <dfn title="已過時，建議不要再使用">已棄用</dfn>，但不移除它，請傳入參數 `deprecated`：

{* ../../docs_src/path_operation_configuration/tutorial006_py310.py hl[16] *}

在互動式文件中，它會被清楚標示為已棄用：

### Terminology

**Public properties** are formally a part of the Public API.
Public properties are **stable properties**: they CANNOT be renamed or removed without notice.
While we normally deprecate the feature or behavior itself, changes to the property cannot happen in a minor release.
Public properties must be documented.

**Internal properties** are not part of the Public API.

## 문서화 *경로 처리* 지원 중단하기 - OpenAPI { #documentation-deprecate-a-path-operation-openapi }

*경로 처리*를 지원 중단(deprecate)으로 표시하고, 문서 UI에 보여주려면 [튜토리얼 - 경로 처리 구성 - 지원 중단](../tutorial/path-operation-configuration.md#deprecate-a-path-operation) 문서를 읽어보세요.

## 어떤 데이터든 JSON 호환으로 변환하기 { #convert-any-data-to-json-compatible }

## Bir *path operation*’ı Deprecate Etmek { #deprecate-a-path-operation }

Bir *path operation*’ı kaldırmadan, <dfn title="eskimiş, kullanılması önerilmez">deprecated</dfn> olarak işaretlemeniz gerekiyorsa `deprecated` parametresini verin:

{* ../../docs_src/path_operation_configuration/tutorial006_py310.py hl[16] *}

Interactive docs’ta deprecated olduğu net şekilde işaretlenecektir: