MitmProxy2Swagger - Outil de rétro-ingénierie automatique pour API REST

 (github.com/alufers)
36 points par xguru 2025-01-03 | 4 commentaires | Partager sur WhatsApp
  • Outil qui convertit automatiquement le trafic HTTP capturé avec mitmproxy en spécification OpenAPI 3.0
  • Permet de rétroconcevoir une API REST simplement en lançant l’application et en capturant le trafic
  • Ajout de la prise en charge du traitement des fichiers HAR exportés depuis les DevTools du navigateur
  • Fonctionnement
    • Capturer le trafic HTTP via mitmproxy (recommandé : utiliser mitmweb)
    • Après avoir enregistré le trafic, exécuter mitmproxy2swagger pour l’analyser et générer un schéma OpenAPI
    • Dans le schéma YAML généré, supprimer ignore: des paths nécessaires et ajuster les détails
    • Relancer mitmproxy2swagger à partir du schéma modifié pour générer la spécification finale
  • Avec le schéma généré, un fichier HTML documenté généré automatiquement est également fourni via redoc-cli

À lire aussi

4 commentaires

 
yangeok 2025-01-05

C'est énorme.
 
dooboo 2025-01-03

Waouh, l’idée est vraiment excellente~
 
bungker 2025-01-03

Quand on développe, il arrive souvent de tomber sur des API non documentées ou sur des API dont la documentation ne correspond pas aux spécifications, donc cela semble pouvoir être d'une grande aide.
 
xguru 2025-01-03

Comme API Parrot – outil de reverse engineering automatique d'API HTTP est en closed source, cet outil est également mentionné dans la discussion.

Consultez aussi les commentaires sur Hacker News : https://news.ycombinator.com/item?id=42572662