rap2需要手動添加接口,代碼零侵入,支持使用模板mock數據,導出postman(配置環境參數)
swagger增強注解生成接口文檔,有侵入性,但是減少手動添加接口工作,不支持mock數據,導出postman(配置環境參數)
使用API文檔管理工具,可以有效管理API接口的版本問題,可以導出postman。
在mock數據方面rap2具有優勢,但是不是必要的選擇,也可以自行模擬更貼合業務場景的數據。
因此,兩款API文檔管理工具就在於你的項目是否可以接受代碼侵入,如果可以,那么可以選擇swagger。