Vous déclarez la forme de la donnée avec des classes et des attributs.

Chaque attribut possède un type.

Puis vous créez une instance de cette classe avec certaines valeurs et **Pydantic** validera les valeurs, les convertira dans le type adéquat (si c'est nécessaire et possible) et vous donnera un objet avec toute la donnée.

Ainsi, votre éditeur vous offrira un support adapté pour l'objet résultant.

* de la donnée soit envoyée par le client à travers le réseau
* de la donnée envoyée depuis votre programme soit reçue par le client à travers le réseau
* le contenu d'un fichier sur le disque soit lu par le système et passé à votre programme

Généralement vous utilisez :

* `POST` : pour créer de la donnée.
* `GET` : pour lire de la donnée.
* `PUT` : pour mettre à jour de la donnée.
* `DELETE` : pour supprimer de la donnée.

Donc, dans **OpenAPI**, chaque méthode HTTP est appelée une "opération".

Nous allons donc aussi appeler ces dernières des "**opérations**".

errors.login_error=Benutzername oder Passwort ist nicht korrekt.
errors.sso_login_error=Verarbeitung des SSO-Logins fehlgeschlagen.
errors.could_not_find_log_file=Konnte {0} nicht finden.
errors.failed_to_start_crawl_process=Start eines Crawl-Vorgangs fehlgeschlagen.
errors.invalid_design_jsp_file_name=Ungültige JSP-Datei.
errors.design_jsp_file_does_not_exist=JSP-Datei existiert nicht.

errors.failed_to_find_plugins=Impossible d'accéder aux plugins disponibles.
errors.failed_to_process_sso_request=Échec du traitement de la requête : {0}

errors.invalid_query_unknown=La requête donnée a une condition inconnue.
errors.invalid_query_parse_error=La requête donnée n'est pas valide.
errors.invalid_query_sort_value=Le tri donné ({0}) n'est pas valide.
errors.invalid_query_unsupported_sort_field=Le tri donné ({0}) n'est pas pris en charge.

Anfangs gab es keine Web-Oberfläche für die automatische API-Dokumentation, aber ich wusste, dass ich Swagger UI hinzufügen konnte.

Er verfügte über ein Dependency Injection System. Es erforderte eine Vorab-Registrierung der Komponenten, wie auch bei anderen oben besprochenen Tools. Aber dennoch, es war ein tolles Feature.

    url: https://github.com/nisutec
  - login: hoenie-ams
    avatarUrl: https://avatars.githubusercontent.com/u/25708487?u=cda07434f0509ac728d9edf5e681117c0f6b818b&v=4
    url: https://github.com/hoenie-ams
  - login: joerambo
    avatarUrl: https://avatars.githubusercontent.com/u/26282974?v=4
    url: https://github.com/joerambo

Tel que `/users/me`, disons pour récupérer les données sur l'utilisateur actuel.

Et vous avez un second chemin : `/users/{user_id}` pour récupérer de la donnée sur un utilisateur spécifique grâce à son identifiant d'utilisateur

Les *fonctions de chemin* étant évaluées dans l'ordre, il faut s'assurer que la fonction correspondant à `/users/me` est déclarée avant celle de `/users/{user_id}` :

Comme les paramètres sont décrits avec des types TypeScript (similaires aux type hints de Python), la prise en charge
par l'éditeur est assez bonne.

* Mindkét _útvonal_ a `GET` műveletet használja (másik elnevezés: HTTP _metódus_).
* A `/items/{item_id}` _útvonalnak_ van egy _path paramétere_, az `item_id`, aminek `int` típusúnak kell lennie.
* A `/items/{item_id}` _útvonalnak_ még van egy opcionális, `str` típusú _query paramétere_ is, a `q`.

### Interaktív API dokumentáció