Saya membuat ini karena setelah selesai menguji API dengan Swagger atau Postman, menulis dokumentasinya lagi secara manual di Notion terasa berulang dan tidak efisien.
Apa yang saya buat: jika Anda mengunggah file Swagger/OpenAPI (.json, .yaml), Postman Collection (.json), atau Insomnia Export (.json), alat ini akan otomatis mengubahnya menjadi dokumen Markdown berisi endpoint/parameter/contoh permintaan·respons yang tersusun rapi. Anda bisa langsung menyalinnya ke Notion atau mengunduhnya sebagai file .md lalu memasukkannya ke repositori.
Cara mencobanya: jika Anda membuka tautan di atas, layar unggah akan langsung muncul. Meski Anda tidak punya file sendiri, ada tombol file contoh untuk tiap format di layar, jadi Anda bisa langsung melihat hasilnya hanya dengan sekali klik.
Apa yang menjadi keunggulannya: saya pernah melihat alat serupa yang hanya mendukung Swagger, tetapi sulit menemukan yang juga mem-parsing file export Postman/Insomnia lalu mengubahnya ke format yang seragam, jadi saya menjadikan bagian ini sebagai pembeda. Alat ini otomatis mengenali formatnya dari isi file.
Saat ini belum ada fitur login, dan untuk Insomnia juga belum bisa mengambil contoh respons, jadi masih berada pada tahap MVP awal. Silakan coba langsung, dan jika ada hal yang terasa kurang nyaman atau format lain yang ingin didukung, jangan ragu tinggalkan komentar.
Tulisan yang menjelaskan lebih detail kenapa saya membuatnya ada di sini:
https://velog.io/@dkslasdud/…
Belum ada komentar.