MitmProxy2Swagger - REST API için otomatik tersine mühendislik aracı

 (github.com/alufers)
36 puan yazan xguru 2025-01-03 | 4 yorum | WhatsApp'ta paylaş
  • mitmproxy ile yakalanan HTTP trafiğini otomatik olarak OpenAPI 3.0 spesifikasyonuna dönüştüren araç
  • Uygulamayı çalıştırıp trafiği yakalamak yeterli; böylece REST API tersine mühendisliği yapılabiliyor
  • Tarayıcı DevTools'tan dışa aktarılan HAR dosyalarını işleme özelliği eklendi
  • Çalışma şekli
    • HTTP trafiğini mitmproxy üzerinden yakalayın (önerilen: mitmweb kullanımı)
    • Trafiği kaydettikten sonra mitmproxy2swagger'ı çalıştırın; araç analiz edip OpenAPI şeması oluşturur
    • Oluşturulan YAML şemasında gerekli Path'lerin ignore: satırını kaldırıp ayrıntıları düzenleyin
    • Düzenlenen şemayı temel alarak mitmproxy2swagger'ı yeniden çalıştırdığınızda nihai spesifikasyon oluşturulur
  • Oluşturulan şemayla birlikte, redoc-cli üzerinden otomatik üretilmiş dokümantasyonlu bir HTML dosyası da sunuluyor

İlgili okumalar

4 yorum

 
yangeok 2025-01-05

Müthişmiş
 
dooboo 2025-01-03

Vay, fikir gerçekten çok iyi~
 
bungker 2025-01-03

Geliştirme yaparken dokümante edilmemiş API'ler ya da doküman ile spesifikasyonu farklı olan API'lerle sıkça karşılaşılabiliyor; bu yüzden oldukça faydalı görünüyor.
 
xguru 2025-01-03

API Parrot – HTTP API otomatik tersine mühendislik aracı kapalı kaynak olduğu için bu araç da birlikte konuşuluyor gibi görünüyor

Hacker News yorumlarına da birlikte göz atın: https://news.ycombinator.com/item?id=42572662