create-api.dev by Kong

create-api.dev est un outil d'IA de Kong, l'entreprise derrière Kong Gateway et Insomnia. Il se présente comme le constructeur OpenAPI de Kong. Il transforme la description écrite d'une API en une spécification OpenAPI exploitable, le fichier standard qui indique aux outils comment vos points d'accès, paramètres et réponses s'articulent. Vous n'écrivez pas le YAML à la main. Vous expliquez ce que l'API doit faire et le constructeur rédige la spec pour vous. En pratique, il fonctionne comme une spécification d'API générée par IA que vous pouvez modifier, pas comme un contrat figé auquel vous vous fiez les yeux fermés.

L'outil est proposé comme un projet Kong Labs. C'est donc un aperçu expérimental, pas un produit pleinement pris en charge. Kong peut le modifier ou l'arrêter à tout moment, et il n'existe ni engagement de disponibilité ni canal de support officiel. Il s'appuie par ailleurs sur les modèles de langage de Google, ce qui fait transiter vos consignes et les résultats par un prestataire tiers.

La principale limite tient à la précision. Une spec rédigée par IA paraît complète, mais elle peut contenir des types de champs erronés, des cas limites manquants ou des exemples inventés. Considérez le résultat comme un bon premier brouillon que vous devez encore relire ligne par ligne avant que quiconque construise dessus.

Getting Started

1. Ouvrez create-api.dev dans votre navigateur et lancez une session. Aucune installation ni formulaire d'inscription n'est requis au préalable.
2. Décrivez l'API en langage courant : ce qu'elle fait, quels points d'accès existent et ce que chacun reçoit et renvoie.
3. Envoyez la description et laissez le constructeur rédiger une spécification OpenAPI à partir d'elle.
4. Relisez le résultat. Vérifiez les chemins, méthodes, paramètres et formats de réponse, puis demandez des changements dans les messages suivants.
5. Exportez ou copiez la spec finalisée dans votre dépôt, puis chargez-la dans Insomnia, Swagger UI ou votre propre pipeline.