Bunun her operation için benzersiz olduğundan emin olmanız gerekir.

{* ../../docs_src/path_operation_advanced_configuration/tutorial001_py310.py hl[6] *}

### operationId olarak *path operation function* adını kullanma { #using-the-path-operation-function-name-as-the-operationid }

OpenAPI 概图会自动添加标签，供 API 文档接口使用：

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

### 使用 Enum 的标签 { #tags-with-enums }

如果你的应用很大，可能会积累出很多标签，你会希望确保相关的*路径操作*始终使用相同的标签。

这种情况下，把标签存放在 `Enum` 中会更合适。

**FastAPI** 对此的支持与使用普通字符串相同：

{* ../../docs_src/path_operation_configuration/tutorial002b_py310.py hl[1,8:10,13,18] *}

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

## Resposta HTML { #html-response }

Para retornar uma resposta com HTML diretamente do **FastAPI**, utilize `HTMLResponse`.

* Importe `HTMLResponse`.
* Passe `HTMLResponse` como o parâmetro de `response_class` do seu *decorador de operação de rota*.

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

/// info | Informação

{* ../../docs_src/response_model/tutorial003_py310.py hl[9,11,16] *}

Obwohl unsere *Pfadoperation-Funktion* hier denselben `user` von der Eingabe zurückgibt, der das Passwort enthält:

{* ../../docs_src/response_model/tutorial003_py310.py hl[24] *}

... haben wir deklariert, dass `response_model` das Modell `UserOut` ist, welches das Passwort nicht enthält:

{* ../../docs_src/security/tutorial001_an_py310.py hl[12] *}

Але це ще не дуже корисно.

Зробімо так, щоб вона повертала поточного користувача.

## Створити модель користувача { #create-a-user-model }

Спочатку створімо модель користувача в Pydantic.

Так само, як ми використовуємо Pydantic для оголошення тіл, ми можемо використовувати його будь-де:

{* ../../docs_src/security/tutorial002_an_py310.py hl[5,12:6] *}

{* ../../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 }

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

Bir exception oluşursa, `Request` instance'ı hâlâ scope içinde olacağı için, hatayı handle ederken request body'yi okuyup kullanabiliriz:

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

## Bir router içinde özel `APIRoute` sınıfı { #custom-apiroute-class-in-a-router }

{* ../../docs_src/path_params/tutorial003_py310.py hl[6,11] *}

Aksi halde, `/users/{user_id}` için olan path, `"me"` değerini `user_id` parametresi olarak aldığını "düşünerek" `/users/me` için de eşleşir.

Benzer şekilde, bir path operation'ı yeniden tanımlayamazsınız:

{* ../../docs_src/path_params/tutorial003b_py310.py hl[6,11] *}

Path önce eşleştiği için her zaman ilk olan kullanılır.

{* ../../docs_src/stream_data/tutorial002_py310.py ln[6,19:20] hl[20] *}

Ardından bu yeni sınıfı *path operation function* içinde `response_class=PNGStreamingResponse` olarak kullanabilirsiniz:

{* ../../docs_src/stream_data/tutorial002_py310.py ln[23:27] hl[23] *}

### Bir Dosyayı Simüle Etme { #simulate-a-file }

Supongamos que la estructura de archivos de tu proyecto se ve así:

```
.
├── app
│   ├── __init__.py
│   ├── main.py
```

Ahora crea un directorio para almacenar esos archivos estáticos.

Tu nueva estructura de archivos podría verse así:

```
.
├── app
│   ├── __init__.py
│   ├── main.py
└── static/
```

### Descarga los archivos { #download-the-files }