API v5: Home "page"

Ce n’est pas la bonne catégorie pour ce message : n’hésitez pas soit à créer la catégorie API si ça a du sens, soit à supprimer mon message (en m’indiquant où poster ces idées).

Sur l’API v5 il n’y a pas de “home”, on obtient même du HTML quand on tape sur /v5/.

Il serait sympa d’y rédiger une petite “home”, je pense par exemple au draft https://mnot.github.io/I-D/json-home/ ou à https://api.github.com/.

Car d’un côté, pour que l’API soit REST (si on pinaille), il faut qu’elle respecte les 6 contraites d’architectures de REST, dont HATEOAS, qui implique l’existance d’une “homepage” d’où un client peut “découvrir” ce qu’il est possible de faire. Et ainsi de proche en proche, ne jamais avoir à forger une URL, mais uniquement les découvrir lors de son parcours, comme un utilisateur clique sur un lien plus souvent qu’il forge une URL.