# MitmProxy2Swagger - REST API 자동 리버스 엔지니어링 도구

> Clean Markdown view of GeekNews topic #18558. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=18558](https://news.hada.io/topic?id=18558)
- GeekNews Markdown: [https://news.hada.io/topic/18558.md](https://news.hada.io/topic/18558.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2025-01-03T10:39:02+09:00
- Updated: 2025-01-03T10:39:02+09:00
- Original source: [github.com/alufers](https://github.com/alufers/mitmproxy2swagger)
- Points: 36
- Comments: 4

## Summary

mitmproxy로 캡처된 HTTP 트래픽을 OpenAPI 3.0 스펙으로 자동 변환하여 REST API를 역설계할 수 있는 도구입니다. 브라우저 DevTools에서 내보낸 HAR 파일도 처리할 수 있으며, 생성된 OpenAPI 스키마를 기반으로 redoc-cli를 통해 문서화된 HTML 파일을 제공합니다.

## Topic Body

- mitmproxy로 캡처된 HTTP 트래픽을 OpenAPI 3.0 스펙으로 자동 변환하는 도구  
- 앱을 실행하고 트래픽을 캡처하는 것만으로 REST API를 역설계할 수 있음  
- 브라우저 DevTools에서 내보낸 HAR 파일을 처리하는 기능 추가됨   
- 동작 방식   
  - mitmproxy (권장: mitmweb 사용)를 통해 HTTP 트래픽을 캡쳐   
  - 트래픽을 저장후 mitmproxy2swagger를 실행하면 분석후 OpenAPI 스키마 생성   
  - 생성된 YAML 스키마에서 필요한 Path의 `ignore:`를 제거하고 세부사항 조정   
  - 수정한 스키마를 기반으로 다시 mitmproxy2swagger를 실행하면 최종 스펙 생성  
- 생성된 스키마와 함께 redoc-cli를 통해 자동 생성된 문서화된 HTML 파일도 제공

## Comments



### Comment 33011

- Author: yangeok
- Created: 2025-01-05T20:51:22+09:00
- Points: 1

대박이네요

### Comment 32952

- Author: dooboo
- Created: 2025-01-03T18:01:52+09:00
- Points: 1

와 아이디어 너무 좋네요~

### Comment 32933

- Author: bungker
- Created: 2025-01-03T13:24:59+09:00
- Points: 1

개발 하다보면 문서화 되지 않은 API나 문서와 스펙이 다른 API가 있는 경우도 많은데  많은 도움이 될것 같습니다.

### Comment 32920

- Author: xguru
- Created: 2025-01-03T10:40:01+09:00
- Points: 1

[API Parrot – HTTP API 자동 리버스 엔지니어링 도구](https://news.hada.io/topic?id=18546) 가 클로즈드소스라서 이 도구가 같이 얘기되고 있네요   
  
해커뉴스의 댓글도 같이 참고하세요 https://news.ycombinator.com/item?id=42572662