OpenAPI et llms.txt
Des descriptions de l’API lisibles par machine.
Deux fichiers décrivent l’API sous forme lisible par machine : openapi.json pour les générateurs de code et les clients API, llms.txt pour les agents IA.
openapi.json
La spécification au format OpenAPI 3.0 décrit les endpoints avec leurs principaux paramètres, réponses, erreurs et l’authentification. Elle couvre aussi les événements livrés par les webhooks. Pour chaque détail, cette documentation fait foi.
https://handelsregister.ai/openapi.json
Comment l’utiliser :
- Avec un générateur comme OpenAPI Generator, tu crées un client typé pour ton langage.
- Importe le fichier dans Postman, Insomnia ou Bruno et tu as tout de suite toutes les requêtes sous la main.
- Les frameworks d’agents construisent à partir du fichier des définitions d’outils pour un modèle de langage.
Ouvre l’URL dans ton navigateur, enregistre le fichier et importe-le.
llms.txt
llms.txt résume l’API sous forme de texte court pour les modèles de langage : endpoints, paramètres, fonctionnalités, prix et règles les plus importantes.
https://handelsregister.ai/llms.txt
Donne l’URL à ton agent IA avant qu’il n’écrive du code pour l’API. Il connaît ainsi les vrais noms de paramètres et champs de réponse.