```Python hl_lines="16"
{!../../../docs_src/path_params/tutorial005.py!}
```

### Documentation

Les valeurs disponibles pour le *paramètre de chemin* sont bien prédéfinies, la documentation les affiche correctement :

<img src="/img/tutorial/path-params/image03.png">

### Manipuler les *énumérations* Python

La valeur du *paramètre de chemin* sera un des "membres" de l'énumération.

## Motivations

Prenons un exemple simple :

```Python
{!../../../docs_src/python_types/tutorial001.py!}
```

Exécuter ce programe affiche :

```
John Doe
```

La fonction :

* Prend un `first_name` et un `last_name`.
* Convertit la première lettre de chaque paramètre en majuscules grâce à `title()`.

Puis le serveur 💁 dit "J'ai fini de préparer les burgers" 🍔 en mettant votre numéro sur l'affichage du comptoir, mais vous ne courrez pas immédiatement au moment où votre numéro s'affiche. Vous savez que personne ne volera vos burgers 🍔 car vous avez votre numéro et les autres clients ont le leur.

labels.businessCategory	=	Catégorie Business
labels.user_registeredAddress	=	Adresse enregistrée
labels.registeredAddress	=	Adresse enregistrée
labels.user_displayName	=	Afficher un nom
labels.displayName	=	Afficher un nom
labels.user_preferredLanguage	=	langue préférée
labels.preferredLanguage	=	langue préférée
labels.user_departmentNumber	=	Numéro de département
labels.departmentNumber	=	Numéro de département

```Python hl_lines="20-31"
{!../../../docs_src/additional_responses/tutorial003.py!}
```

Tout sera combiné et inclus dans votre OpenAPI, et affiché dans la documentation de l'API :

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

## Combinez les réponses prédéfinies et les réponses personnalisées

system](https://fess.codelibs.org/14.12/admin/fileconfig-guide.html), or [Data Store](https://fess.codelibs.org/14.12/admin/dataconfig-guide.html) (such as a CSV or database). Many file formats are supported including (but not limited to): Microsoft Office, PDF, and zip.

*[Fess Site Search](https://github.com/codelibs/fess-site-search)* is a free alternative to [Google Site Search](https://enterprise.google.com/search/products/gss.html). For more details, see the [FSS JS Generator document...

```Python hl_lines="6"
{!../../../docs_src/path_operation_advanced_configuration/tutorial003.py!}
```

## Description avancée de docstring

Vous pouvez limiter le texte utilisé de la docstring d'une *fonction de chemin* qui sera affiché sur OpenAPI.

L'ajout d'un `\f` (un caractère d'échappement "form feed") va permettre à **FastAPI** de tronquer la sortie utilisée pour OpenAPI à ce stade.

labels.pager=Pager
labels.user_street=Street
labels.street=Street
labels.user_postalCode=Postal Code
labels.postalCode=Postal Code
labels.user_physicalDeliveryOfficeName=Physical Delivery Office Name
labels.physicalDeliveryOfficeName=Physical Delivery Office Name
labels.user_destinationIndicator=Destination Indicator
labels.destinationIndicator=Destination Indicator
labels.user_internationaliSDNNumber=International ISDN Number

labels.pager=Pager
labels.user_street=Street
labels.street=Street
labels.user_postalCode=Postal Code
labels.postalCode=Postal Code
labels.user_physicalDeliveryOfficeName=Physical Delivery Office Name
labels.physicalDeliveryOfficeName=Physical Delivery Office Name
labels.user_destinationIndicator=Destination Indicator
labels.destinationIndicator=Destination Indicator
labels.user_internationaliSDNNumber=International ISDN Number

## Documentation automatique

Les schémas JSON de vos modèles seront intégrés au schéma OpenAPI global de votre application, et seront donc affichés dans la documentation interactive de l'API :

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

Et seront aussi utilisés dans chaque *opération de chemin* de la documentation utilisant ces modèles :