OpenAPI
OpenAPI est un schéma lisible par machine décrivant chaque endpoint, paramètre et réponse d'une API REST, à partir duquel générer des clients.
En détail
Cette API publie un document OpenAPI 3.1 aux côtés d'un index llms.txt, ce qui permet à un générateur de SDK, à une collection Postman ou à un framework d'agent de comprendre la surface sans que personne n'ait à lire de la prose. C'est la source de vérité pour la forme des requêtes et les codes de statut. Les changements de comportement sont annoncés dans le changelog avant leur mise en service, si bien qu'un client généré se régénère délibérément au lieu d'être découvert cassé.
Aussi appelé
- swagger
- api schema