La valeur de la variable `PATH` est une longue chaîne composée de répertoires séparés par deux-points `:` sous Linux et macOS, et par point-virgule `;` sous Windows.

Par exemple, la variable d'environnement `PATH` peut ressembler à ceci :

//// tab | Linux, macOS

```plaintext
/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
```

Cela signifie que le système doit rechercher les programmes dans les répertoires :

* `/usr/local/bin`

say_hi()  # Oh non, cela lève une erreur ! 😱
```

Le paramètre `name` est toujours requis (pas facultatif) car il n'a pas de valeur par défaut. En revanche, `name` accepte `None` comme valeur :

```Python
say_hi(name=None)  # Ceci fonctionne, None est valide 🎉
```

La bonne nouvelle, c'est que, dans la plupart des cas, vous pourrez simplement utiliser `|` pour définir des unions de types :

```python
def say_hi(name: str | None):

Vous pouvez alors désactiver OpenAPI (y compris les interfaces utilisateur des documents) en définissant la variable d'environnement `OPENAPI_URL` sur la chaîne vide, comme ceci :

<div class="termy">

```console
$ OPENAPI_URL= uvicorn main:app

<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
```

</div>

## Cas d'utilisation { #use-case }

Commençons par un exemple de **cas d'utilisation**, puis voyons comment le résoudre avec ceci.

Imaginons que vous ayez des **modèles d'apprentissage automatique** que vous souhaitez utiliser pour traiter des requêtes. 🤖

{* ../../docs_src/schema_extra_example/tutorial003_an_py310.py hl[22:29] *}

### Exemple dans l'interface des documents { #example-in-the-docs-ui }

Avec l'une des méthodes ci-dessus, cela ressemblerait à ceci dans le `/docs` :

<img src="/img/tutorial/body-fields/image01.png">

### `Body` avec plusieurs `examples` { #body-with-multiple-examples }

Vous pouvez bien sûr aussi passer plusieurs `examples` :

Cela vous permet de **réutiliser le modèle** à **plusieurs endroits** et aussi de déclarer des validations et des métadonnées pour tous les paramètres en une seule fois. 😎

/// note | Remarque

Ceci est pris en charge depuis la version `0.115.0` de FastAPI. 🤓

///

/// tip | Astuce

Cette même technique s'applique à `Query`, `Cookie` et `Header`. 😎

///

{* ../../docs_src/header_params/tutorial003_an_py310.py hl[9] *}

Si vous communiquez avec ce *chemin d'accès* en envoyant deux en-têtes HTTP comme :

```
X-Token: foo
X-Token: bar
```

La réponse ressemblerait à ceci :

```JSON
{
    "X-Token values": [
        "bar",
        "foo"
    ]
}
```

## Récapitulatif { #recap }

│   └── test_main.py
```

Le fichier `main.py` contiendrait :

{* ../../docs_src/async_tests/app_a_py310/main.py *}

Le fichier `test_main.py` contiendrait les tests pour `main.py`, il pourrait maintenant ressembler à ceci :

{* ../../docs_src/async_tests/app_a_py310/test_main.py *}

## Exécuter { #run-it }

Vous pouvez lancer vos tests comme d'habitude via :

<div class="termy">

```console
$ pytest

---> 100%

En particulier, cela peut être une bonne alternative à une logique dans un middleware.

Par exemple, si vous voulez lire ou manipuler le corps de la requête avant qu'il ne soit traité par votre application.

/// danger | Danger

Ceci est une fonctionnalité « avancée ».

Si vous débutez avec **FastAPI**, vous pouvez ignorer cette section.

///

## Cas d'utilisation { #use-cases }

Voici quelques cas d'utilisation :

# Tâches d'arrière-plan { #background-tasks }

Vous pouvez définir des tâches d'arrière-plan qui seront exécutées après avoir retourné une réponse.

Ceci est utile pour les opérations qui doivent avoir lieu après une requête, mais où le client n'a pas réellement besoin d'attendre que l'opération soit terminée pour recevoir une réponse.

Cela comprend, par exemple :

* Les notifications par email envoyées après l'exécution d'une action :