API testlerini Swagger ya da Postman ile bitirdim ama asıl dokümantasyonu Notion'a ayrıca elle
yazmanın sürekli tekrar eden ve verimsiz bir iş olduğunu hissedince bunu yaptım.
Ne yaptım: Swagger/OpenAPI (.json, .yaml), Postman Collection (.json),
Insomnia Export (.json) dosyalarından herhangi birini yüklediğinizde, endpoint/parametre/istek·yanıt
örneklerini düzenlenmiş bir Markdown dokümanına otomatik olarak dönüştürüyor. Olduğu gibi kopyalayıp Notion'a yapıştırabilir
ya da .md dosyası olarak alıp repoya koyabilirsiniz.
Nasıl deneyebilirsiniz: Yukarıdaki bağlantıya girdiğinizde doğrudan yükleme ekranı açılıyor; elinizde
dosya olmasa bile ekranda formatlara göre örnek dosya butonları var, tek tıkla hemen
sonucu görebilirsiniz.
Öne çıkan tarafı ne: Yalnızca Swagger destekleyen benzer araçlar gördüm ama Postman/Insomnia
export dosyalarını da birlikte parse edip ortak bir formata dönüştüren bir şeyi bulmak zordu; bu kısmı
farklılaştırıcı nokta olarak aldım. Dosya içeriğine bakıp hangi format olduğunu otomatik olarak tespit ediyor.
Henüz giriş özelliği yok ve Insomnia tarafında örnek yanıta kadar veriyi alamamak gibi ilk MVP
aşamasına ait eksikler var. Gerçekten kullanıp rahatsız olduğunuz noktalar ya da şu format da desteklense iyi olur
dediğiniz şeyler varsa yorumlara rahatça yazın.
Bunu neden yaptığımı biraz daha detaylı anlattığım yazıyı buraya bırakıyorum:
https://velog.io/@dkslasdud/…
Henüz yorum yok.