Tôi tạo công cụ này vì cảm thấy việc kiểm thử API bằng Swagger hay Postman đã xong, nhưng rồi lại phải gõ thủ công tài liệu riêng trên Notion là lặp đi lặp lại và kém hiệu quả.
Công cụ này làm gì: Khi bạn tải lên bất kỳ file nào trong số Swagger/OpenAPI(.json, .yaml), Postman Collection(.json),
Insomnia Export(.json), công cụ sẽ tự động chuyển đổi thành tài liệu Markdown đã sắp xếp endpoint/tham số/ví dụ request·response. Bạn có thể sao chép nguyên văn để dán vào Notion
hoặc tải về dưới dạng file .md rồi đưa vào repo.
Cách trải nghiệm: Vào liên kết ở trên là thấy ngay màn hình upload; ngay cả khi không có file sẵn, trên màn hình vẫn có các nút file mẫu theo từng định dạng, nên chỉ cần một cú nhấp là có thể xem kết quả ngay.
Điểm nổi bật: Tôi từng thấy các công cụ tương tự chỉ hỗ trợ Swagger, nhưng khó tìm được công cụ parse cả file export Postman/Insomnia rồi chuyển đổi sang một định dạng thống nhất, nên tôi chọn phần này làm điểm khác biệt. Công cụ tự động nhận diện định dạng dựa trên nội dung file.
Hiện chưa có chức năng đăng nhập, và với Insomnia thì vẫn chưa lấy được đến ví dụ response, nên đây còn là giai đoạn MVP ban đầu. Nếu bạn dùng thử thực tế và thấy điểm nào bất tiện, hoặc muốn hỗ trợ thêm định dạng nào, hãy thoải mái để lại bình luận.
Tôi có viết thêm một bài giải thích chi tiết hơn vì sao tôi tạo công cụ này ở đây:
https://velog.io/@dkslasdud/…
Chưa có bình luận nào.