betagouv / preuve-covoiturage

Registre de preuve de covoiturage
https://app.covoiturage.beta.gouv.fr
Apache License 2.0
35 stars 12 forks source link

Evolution Documentation API #2644

Open nicolas-viennot-beta opened 1 month ago

nicolas-viennot-beta commented 1 month ago

Besoin : faciliter la compréhension de notre API Trajet en complétant la documentation d'une représentation sous forme de mapping

Objectif : clarifier les interactions et faciliter la communication avec les opérateurs

Proposition : Faire un mapping imbriquant

illustre comment les différentes parties d'une API interagissent au fil du temps.

Montre le flux entre plusieurs services au sein d'une architecture microservices.

Donne un aperçu des différents endpoints disponibles et de leurs relations (par exemple, hiérarchies, regroupements par fonctionnalités).

inclue des informations sur les méthodes HTTP (GET, POST, etc.) et les paramètres associés à chaque endpoint.

nicolas-viennot-beta commented 18 hours ago

vérifier la limite des 48h sur le finalize