For gradual adoption, enable checks project-by-project.
Do not rely on `@NullMarked` annotations.
Only enable checks for a project if all its dependencies have checks enabled, in order to avoid back-and-forth when refining the annotations.

Avoid writing the so-called `PolyNull` or `ParametricNull` methods (where nullability of the result depends on the nullability of the type argument).

Aqui declaramos a configuração `openapi_url` com o mesmo padrão de `"/openapi.json"`.

E então a usamos ao criar a aplicação `FastAPI`.

Então você pode desabilitar o OpenAPI (incluindo a documentação da interface do usuário) definindo a variável de ambiente `OPENAPI_URL` como a string vazia, como:

<div class="termy">

```console
$ OPENAPI_URL= uvicorn main:app

Como exemplo, veja esta função:

```python
from typing import Optional


def say_hi(name: Optional[str]):
    print(f"Hey {name}!")
```

O parâmetro `name` é definido como `Optional[str]`, mas não é opcional; não é possível chamar a função sem o parâmetro:

```Python
say_hi()  # Ah, não, isso gera um erro! 😱
```

Désormais, si vous consultez les documents, ils afficheront toutes les métadonnées supplémentaires :

<img src="/img/tutorial/metadata/image02.png">

### Définir l’ordre des tags { #order-of-tags }

L’ordre de chaque dictionnaire de métadonnées de tag définit également l’ordre affiché dans l’interface utilisateur de la documentation.

# Cookies de réponse { #response-cookies }

## Utiliser un paramètre `Response` { #use-a-response-parameter }

Vous pouvez déclarer un paramètre de type `Response` dans votre *fonction de chemin d'accès*.

Vous pouvez ensuite définir des cookies dans cet objet de réponse *temporaire*.

{* ../../docs_src/response_cookies/tutorial002_py310.py hl[1, 8:9] *}

Ele usará o código de status padrão ou o que você definir na sua *operação de rota*.

## Códigos de status adicionais { #additional-status-codes_1 }

Caso você queira retornar códigos de status adicionais além do código principal, você pode fazer isso retornando um `Response` diretamente, como por exemplo um `JSONResponse`, e definir os códigos de status adicionais diretamente.

# Parámetros de Header { #header-parameters }

Puedes definir los parámetros de Header de la misma manera que defines los parámetros de `Query`, `Path` y `Cookie`.

## Importar `Header` { #import-header }

Primero importa `Header`:

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

## Declarar parámetros de `Header` { #declare-header-parameters }

Vous pouvez définir le paramètre du *décorateur de chemin d'accès* `response_model_exclude_unset=True` :

{* ../../docs_src/response_model/tutorial004_py310.py hl[22] *}

et ces valeurs par défaut ne seront pas incluses dans la réponse, uniquement les valeurs effectivement définies.

# Parámetros de Cookie { #cookie-parameters }

Puedes definir parámetros de Cookie de la misma manera que defines los parámetros `Query` y `Path`.

## Importar `Cookie` { #import-cookie }

Primero importa `Cookie`:

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

## Declarar parámetros de `Cookie` { #declare-cookie-parameters }

Luego declara los parámetros de cookie usando la misma estructura que con `Path` y `Query`.

# Utiliser des formulaires et des fichiers de requête { #request-forms-and-files }

Vous pouvez définir des fichiers et des champs de formulaire en même temps à l'aide de `File` et `Form`.

/// info

Pour recevoir des fichiers téléversés et/ou des données de formulaire, installez d'abord [`python-multipart`](https://github.com/Kludex/python-multipart).