Les tests d’API étaient terminés avec Swagger ou Postman, mais je trouvais répétitif et inefficace de devoir ensuite saisir la documentation à la main séparément dans Notion.
Ce que j’ai créé : en important n’importe quel fichier parmi Swagger/OpenAPI (.json, .yaml), Postman Collection (.json) ou Insomnia Export (.json), l’outil le convertit automatiquement en un document Markdown structuré avec endpoints, paramètres et exemples de requêtes/réponses. Vous pouvez le copier tel quel dans Notion, ou le télécharger en fichier .md et l’ajouter à votre repo.
Comment l’essayer : en ouvrant le lien ci-dessus, vous arrivez directement sur l’écran d’import. Même si vous n’avez pas de fichier sous la main, des boutons de fichiers d’exemple par format sont disponibles à l’écran, ce qui permet de vérifier le résultat en un clic.
Ce qui le distingue : j’ai vu des outils similaires qui ne prennent en charge que Swagger, mais il est difficile d’en trouver qui parsèrent aussi les exports Postman/Insomnia et les convertissent dans un format unifié. J’en ai donc fait l’élément différenciant. L’outil détecte automatiquement le format en analysant le contenu du fichier.
Il n’y a pas encore de fonctionnalité de connexion, et Insomnia ne permet pas encore de récupérer jusqu’aux exemples de réponses : c’est un MVP initial. Essayez-le, et si vous rencontrez des points gênants ou si vous souhaitez la prise en charge d’autres formats, n’hésitez pas à laisser un commentaire.
J’ai également laissé ici un billet expliquant un peu plus en détail pourquoi je l’ai créé : https://velog.io/@dkslasdud/…
Aucun commentaire pour le moment.