Ce code ne sera pas exécuté dans votre application, nous en avons seulement besoin pour *documenter* à quoi devrait ressembler cette *API externe*.

Mais vous savez déjà comment créer facilement une documentation automatique pour une API avec **FastAPI**.

Voici à quoi cela pourrait ressembler :

{* ../../docs_src/dependencies/tutorial013_an_py310.py *}

Le code d’arrêt, la fermeture automatique de la `Session` dans :

{* ../../docs_src/dependencies/tutorial013_an_py310.py ln[19:21] *}

... serait exécuté après que la réponse a fini d’envoyer les données lentes :

- Afficher une **erreur claire** au client quand les données ne sont pas valides
- **Documenter** le paramètre dans la *chemin d'accès* du schéma OpenAPI (il apparaîtra donc dans l’**interface de documentation automatique**)

## Alternative (ancienne) : `Query` comme valeur par défaut { #alternative-old-query-as-the-default-value }

Par exemple, si vous déclarez un paramètre de type `Hero`, il sera lu depuis le **corps JSON**.

De la même manière, vous pouvez le déclarer comme **type de retour** de la fonction, et alors la forme des données apparaîtra dans l'UI automatique de documentation de l'API.

{* ../../docs_src/sql_databases/tutorial001_an_py310.py ln[40:45] hl[40:45] *}

* L'apprentissage automatique (ou **Machine Learning**) : cela nécessite de nombreuses multiplications de matrices et vecteurs. Imaginez une énorme feuille de calcul remplie de nombres que vous multiplierez entre eux tous au même moment.

Cela peut être utile si, par exemple, vous vivez dans un pays qui restreint certaines URL.

### Désactiver les docs automatiques { #disable-the-automatic-docs }

La première étape consiste à désactiver les docs automatiques, car par défaut elles utilisent le CDN par défaut.

Pour les désactiver, définissez leurs URL sur `None` lors de la création de votre application `FastAPI` :

* Excellente prise en charge dans l'éditeur.
* Conversion des données à partir des requêtes entrantes.
* Conversion des données pour les données de réponse.
* Validation des données.
* Annotations et documentation automatiques.

## Autres types de données { #other-data-types }

Voici quelques types de données supplémentaires que vous pouvez utiliser :

* `UUID` :

- 📞 [Traefik](https://traefik.io) comme proxy inverse / répartiteur de charge.
- 🚢 Instructions de déploiement avec Docker Compose, y compris la configuration d'un proxy Traefik frontal pour gérer les certificats HTTPS automatiques.

{* ../../docs_src/path_operation_configuration/tutorial002_py310.py hl[15,20,25] *}

Ils seront ajoutés au schéma OpenAPI et utilisés par les interfaces de documentation automatiques :

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

### Utiliser des tags avec Enum { #tags-with-enums }

* **Valider des données** : provenant de chaque requête :
    * En générant des **erreurs automatiques** renvoyées au client lorsque la donnée est invalide.
* **Documenter** l'API avec OpenAPI :
    * ce qui est ensuite utilisé par les interfaces utilisateur de documentation interactive automatiques.