Spec OpenAPI

La carte complète et lisible par machine de l'API : chaque endpoint, requête, réponse et erreur.

OpenAPI est le format standard de l'industrie pour décrire une API HTTP dans un fichier lisible par machine.

https://api.wontopos.com/openapi.json

Ce que ça permet

Postman : File → Import → collez l'URL, tous les endpoints apparaissent en collection cliquable. ChatGPT : créez un GPT, ajoutez une Action, collez la même URL. Codegen : openapi-generator -i .../openapi.json -g go génère un client dans un langage que nous ne publions pas.

Importez-la dans Postman, générez un client dans un langage que nous ne publions pas, branchez ChatGPT Actions ou lancez des checks de contrat en CI. Un test l'épingle aux routes réelles : aucune dérive possible.

llms.txt

Toute l'API sur une page de texte qu'une IA peut lire.

llms.txt est une convention du web : une page en texte brut à la racine du site qui dit à une IA tout ce qu'elle doit savoir d'un produit.

https://wontopos.com/llms.txt

Déposez-le dans votre IDE ou agent de code : il sait construire sur WOS - auth, endpoints, patterns, erreurs. Mis à jour à chaque release.

Les mêmes faits que la spec OpenAPI, un autre public : la spec est une structure précise pour les outils ; ce fichier est de la prose qu'une IA (ou une personne) lit d'une traite. Les deux se mettent à jour à chaque release.