- Ferramenta que converte automaticamente o tráfego HTTP capturado pelo mitmproxy em uma especificação OpenAPI 3.0
- É possível fazer a engenharia reversa de APIs REST apenas executando o app e capturando o tráfego
- Foi adicionada a função de processar arquivos HAR exportados do DevTools do navegador
- Como funciona
- Captura o tráfego HTTP por meio do mitmproxy (recomendado: usar o mitmweb)
- Depois de salvar o tráfego, execute o mitmproxy2swagger para analisá-lo e gerar um schema OpenAPI
- No schema YAML gerado, remova
ignore: dos Paths necessários e ajuste os detalhes
- Execute novamente o mitmproxy2swagger com base no schema modificado para gerar a especificação final
- Junto com o schema gerado, também fornece um arquivo HTML documentado gerado automaticamente via redoc-cli
4 comentários
Incrível mesmo
Uau, que ideia boa demais~
Ao desenvolver, muitas vezes nos deparamos com APIs não documentadas ou APIs cuja documentação e especificação diferem, então isso parece que será de grande ajuda.
Como o API Parrot – ferramenta de engenharia reversa automática de APIs HTTP é closed source, esta ferramenta também está sendo mencionada junto.
Veja também os comentários no Hacker News: https://news.ycombinator.com/item?id=42572662