캡처된 API 트래픽에서 OpenAPI 스펙 부트스트래핑 (클라이언트 또는 테스트 자동화 전)
mitmproxy2swagger를 사용하여 캡처된 mitmproxy 플로우나 HAR 내보내기 파일을 1차 OpenAPI 문서로 변환합니다. 에이전트가 이를 정제, 검증하고 다운스트림 도구에 전달할 수 있습니다. API는 이미 존재하지만 계약(contract)이 없고, 클라이언트, 모의(mock), 테스트, 검토 가능한 문서를 생성하기 전에 구체적인 스펙이 필요할 때 사용하세요.
사전 조건
Python 3 및 pip, 그리고 mitmproxy 플로우 캡처 또는 브라우저 DevTools의 HAR 내보내기 파일
설치
환경에 맞는 상위 설치 또는 설정 경로를 사용하세요:
pip install mitmproxy2swaggergit clone [email protected]:alufers/mitmproxy2swagger.gitdocker build -t mitmproxy2swagger .docker run -it -v $PWD:/app mitmproxy2swagger mitmproxy2swagger -i <mitmproxy_플로우_경로> -o <출력_스키마_경로> -p <API_접두사>
상위 저장소의 요구 사항 및 주의 사항:
- poetry (의존성 관리용)
기본 사용법 또는 시작 노트:
-
먼저 python3와 pip3가 필요합니다.
-
bash
-
... 또는 ...
-
상위 문서에서 추출: https://raw.githubusercontent.com/alufers/mitmproxy2swagger/HEAD/README.md