介面文件生成工具 apidoc

2021-09-16 12:18:20 字數 714 閱讀 9539

apidoc在您的源**中通過建立api注釋從而生成api說明文件。

我們以express的專案為例

1 建立apidoc.json

}

2 我們在routes資料夾下建立api資料夾,用於書寫介面注釋說明,例如

/**

* @api /news/newscontent 新聞詳情

* @apiversion 1.0.0

* @apiname newscontent

* @apigroup news

* @apiparam id 新聞id

* @apisuccess code 結果標識

* @apisuccess message 結果說明

* @apisuccess data 結果資料

*/

3 呼叫生成命令

apidoc -i routes/ -o public/apidoc/
以上命令的意思是讀取routes資料夾下的api配置,輸出api說明文件到public/apidoc/資料夾

開啟生成後的index.html即可

介面文件自動生成工具apidoc

前後端分離之後,介面文件是前後端溝通的必要手段。然後介面文件包含大量的重複性工作,費時費力,像apidoc這樣工具就十分必要了。官方文件 首先說一下自己遇到的坑 1 安裝,node.js版本要高 在官網下最新的就行 不然後面有的模組會出問題,導致apidoc無法使用。2 生成介面文件之後,把文件放到...

apidoc生成介面文件

e soft node node global node v v12.18.2 e soft node node global npm v 6.14.5 npm install apidoc g安裝之後進入node的node global目錄如下圖說明安裝完成 增加apidoc.json檔案到專案根...

自動生成apidoc介面文件

開發過程中,個人認為編寫介面文件是個很煩人的事,沒有或者隨便寫,前端對接的時候不清楚就更煩人了。使用aoidoc可以簡化這個操作,可我有時候連apidoc的注釋都懶得寫 api management smhard insert 新增 apiname insert apigroup 智慧型裝置 api...