Сначала напишите приложение **FastAPI** как обычно:

{* ../../docs_src/extending_openapi/tutorial001_py310.py hl[1,4,7:9] *}

### Сгенерируйте схему OpenAPI { #generate-the-openapi-schema }

Затем используйте ту же вспомогательную функцию для генерации схемы OpenAPI внутри функции `custom_openapi()`:

{* ../../docs_src/extending_openapi/tutorial001_py310.py hl[2,15:21] *}

### Измените схему OpenAPI { #modify-the-openapi-schema }

{* ../../docs_src/extending_openapi/tutorial001_py310.py hl[1,4,7:9] *}

### OpenAPI Şemasını Üretme { #generate-the-openapi-schema }

Ardından, bir `custom_openapi()` fonksiyonunun içinde aynı yardımcı fonksiyonu kullanarak OpenAPI şemasını üretin:

{* ../../docs_src/extending_openapi/tutorial001_py310.py hl[2,15:21] *}

### OpenAPI Şemasını Değiştirme { #modify-the-openapi-schema }

      - name: Update Languages
        run: uv run ./scripts/docs.py update-languages
      - uses: actions/cache@v5
        with:
          key: mkdocs-cards-${{ matrix.lang }}-${{ github.ref }}
          path: docs/${{ matrix.lang }}/.cache
      - name: Build Docs
        run: uv run ./scripts/docs.py build-lang ${{ matrix.lang }}
      - uses: actions/upload-artifact@v7
        with:

{* ../../docs_src/dependencies/tutorial002_an_py310.py hl[11:15] *}

Class instance'ını oluşturmak için kullanılan `__init__` metoduna dikkat edin:

{* ../../docs_src/dependencies/tutorial002_an_py310.py hl[12] *}

...bizim önceki `common_parameters` ile aynı parametrelere sahip:

{* ../../docs_src/dependencies/tutorial001_an_py310.py hl[8] *}

### 缓存 OpenAPI 架构 { #cache-the-openapi-schema }

你可以把 `.openapi_schema` 属性当作“缓存”，用来存储已生成的架构。

这样一来，用户每次打开 API 文档时，应用就不必重新生成架构。

它只会生成一次，后续请求都会使用同一份缓存的架构。

{* ../../docs_src/extending_openapi/tutorial001_py310.py hl[13:14,25:26] *}

### 覆盖方法 { #override-the-method }

现在你可以用你的新函数替换 `.openapi()` 方法。

{* ../../docs_src/extending_openapi/tutorial001_py310.py hl[29] *}

{* ../../docs_src/response_model/tutorial001_01_py310.py ln[15:17] hl[16] *}

## Réponse HTML { #html-response }

Pour renvoyer une réponse avec du HTML directement depuis **FastAPI**, utilisez `HTMLResponse`.

- Importez `HTMLResponse`.
- Passez `HTMLResponse` comme paramètre `response_class` de votre *décorateur de chemin d'accès*.

{* ../../docs_src/custom_response/tutorial002_py310.py hl[2,7] *}

/// info

{* ../../docs_src/dependencies/tutorial002_an_py310.py hl[11:15] *}

Обратите внимание на метод `__init__`, используемый для создания экземпляра класса:

{* ../../docs_src/dependencies/tutorial002_an_py310.py hl[12] *}

...он имеет те же параметры, что и ранее используемая функция `common_parameters`:

{* ../../docs_src/dependencies/tutorial001_an_py310.py hl[8] *}

`fastapi` içinden `File` ve `UploadFile` import edin:

{* ../../docs_src/request_files/tutorial001_an_py310.py hl[3] *}

## `File` Parametrelerini Tanımlayın { #define-file-parameters }

`Body` veya `Form` için yaptığınız gibi dosya parametreleri oluşturun:

{* ../../docs_src/request_files/tutorial001_an_py310.py hl[9] *}

/// info | Bilgi

`File`, doğrudan `Form`’dan türeyen bir sınıftır.

{* ../../docs_src/path_params_numeric_validations/tutorial002_py310.py hl[7] *}

Але майте на увазі, що якщо ви використовуєте `Annotated`, цієї проблеми не буде, це не матиме значення, оскільки ви не використовуєте значення за замовчуванням параметрів функції для `Query()` або `Path()`.

{* ../../docs_src/path_params_numeric_validations/tutorial002_an_py310.py *}

{* ../../docs_src/custom_request_and_route/tutorial002_an_py310.py hl[14,16] *}

Если произойдёт исключение, экземпляр `Request` всё ещё будет в области видимости, поэтому мы сможем прочитать тело запроса и использовать его при обработке ошибки:

{* ../../docs_src/custom_request_and_route/tutorial002_an_py310.py hl[17:19] *}

## Пользовательский класс `APIRoute` в роутере { #custom-apiroute-class-in-a-router }