Sebastián Ramírez <******@****.***> 1766004103 -0800

Sebastián Ramírez <******@****.***> 1766004103 -0800

Sebastián Ramírez <******@****.***> 1766004103 -0800

Sebastián Ramírez <******@****.***> 1766004103 -0800

{* ../../docs_src/first_steps/tutorial001_py39.py hl[7] *}

Это функция на Python.

**FastAPI** будет вызывать её каждый раз, когда получает запрос к URL «`/`» с операцией `GET`.

В данном случае это асинхронная (`async`) функция.

---

Вы также можете определить её как обычную функцию вместо `async def`:

{* ../../docs_src/first_steps/tutorial003_py39.py hl[7] *}

/// note | Примечание

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

### Better with `Annotated` { #better-with-annotated }

{* ../../docs_src/first_steps/tutorial001_py39.py hl[7] *}

Esta é uma função Python.

Ela será chamada pelo **FastAPI** sempre que receber uma requisição para a URL "`/`" usando uma operação `GET`.

Neste caso, é uma função `async`.

---

Você também pode defini-la como uma função normal em vez de `async def`:

{* ../../docs_src/first_steps/tutorial003_py39.py hl[7] *}

/// note | Nota

{* ../../docs_src/first_steps/tutorial001_py39.py hl[7] *}

Esta es una función de Python.

Será llamada por **FastAPI** cuando reciba un request en la URL "`/`" usando una operación `GET`.

En este caso, es una función `async`.

---

También podrías definirla como una función normal en lugar de `async def`:

{* ../../docs_src/first_steps/tutorial003_py39.py hl[7] *}

/// note | Nota

E um retorno com o código de status `200` que utiliza o seu `response_model`, porém inclui um `example` customizado:

{* ../../docs_src/additional_responses/tutorial003_py39.py hl[20:31] *}

Isso será combinado e incluído em seu OpenAPI, e disponibilizado na documentação da sua API:

<img src="/img/tutorial/additional-responses/image01.png">

你可以自定义该函数。它接受一个 `APIRoute` 对象作为输入，并输出一个字符串。

例如，以下是一个示例，它使用第一个标签（你可能只有一个标签）和*路径操作*名称（函数名）。

然后，你可以将这个自定义函数作为 `generate_unique_id_function` 参数传递给 **FastAPI**:

{* ../../docs_src/generate_clients/tutorial003_py39.py hl[6:7,10] *}

### 使用自定义操作ID生成TypeScript客户端

现在，如果你再次生成客户端，你会发现它具有改善的方法名称：

<img src="/img/tutorial/generate-clients/image07.png">

正如你所见，现在方法名称中只包含标签和函数名，不再包含URL路径和HTTP操作的信息。