Generar especificación OpenAPI a partir de tráfico de API capturado antes de comenzar la automatización de clientes o pruebas
Utiliza mitmproxy2swagger para convertir flujos de mitmproxy capturados o exportaciones HAR en un documento OpenAPI inicial que un agente puede refinar, validar y entregar a herramientas posteriores. Invócalo cuando la API ya exista pero no tenga un contrato definido, y necesites una especificación concreta antes de generar clientes, mocks, pruebas o documentación revisable.
Prerrequisitos
Python 3 y pip, además de capturas de flujo de mitmproxy o una exportación HAR desde las herramientas de desarrollo del navegador
Instalación
Usa la instalación oficial o la ruta de configuración que coincida con tu entorno:
- $ pip install mitmproxy2swagger
- $ git clone [email protected]:alufers/mitmproxy2swagger.git
- $ docker build -t mitmproxy2swagger .
- $ docker run -it -v $PWD:/app mitmproxy2swagger mitmproxy2swagger -i <ruta_al_flujo_de_mitmproxy> -o <ruta_al_esquema_de_salida> -p <prefijo_de_la_api>
Requisitos y advertencias del proyecto original:
- poetry para la gestión de dependencias
Notas de uso básico o inicio rápido:
-
Primero necesitarás python3 y pip3.
-
bash
-
... o ...
-
Extraído de la documentación oficial: https://raw.githubusercontent.com/alufers/mitmproxy2swagger/HEAD/README.md