- Herramienta que convierte automáticamente el tráfico HTTP capturado con mitmproxy en una especificación OpenAPI 3.0
- Permite hacer ingeniería inversa de una API REST con solo ejecutar la app y capturar el tráfico
- Se agregó la función para procesar archivos HAR exportados desde las DevTools del navegador
- Cómo funciona
- Captura el tráfico HTTP mediante mitmproxy (recomendado: usar mitmweb)
- Después de guardar el tráfico, ejecuta mitmproxy2swagger para analizarlo y generar un esquema OpenAPI
- En el esquema YAML generado, elimina
ignore: de los Path necesarios y ajusta los detalles
- Si vuelves a ejecutar mitmproxy2swagger con base en el esquema modificado, se genera la especificación final
- Junto con el esquema generado, también ofrece un archivo HTML documentado generado automáticamente mediante redoc-cli
4 comentarios
Está increíble.
Vaya, la idea está buenísima~
Al desarrollar, a menudo hay APIs sin documentar o APIs cuya documentación no coincide con la especificación, así que parece que será de gran ayuda.
Como API Parrot – herramienta de ingeniería inversa automática de API HTTP es de código cerrado, parece que también se está hablando de esta herramienta.
También conviene revisar los comentarios en Hacker News: https://news.ycombinator.com/item?id=42572662