編寫介面文件apidoc用法

2021-08-07 05:21:12 字數 1430 閱讀 4577

一、使用 npm install apidoc -g

三、在目錄裡面編寫注釋

/**

* * @api /company/list 獲取公司資訊testm

* @apiname 獲取公司列表testd

* @apigroup all

* @apiversion 0.1.0

* @apidescription 介面詳細描述

* * @apiparam pagenum分頁大小

* * @apisuccess code 結果碼

* @apisuccess msg 訊息說明

* @apisuccess data 分頁資料封裝

* @apisuccess data.count 總記錄數

* @apisuccess data.list 分頁資料物件陣列

* * @apierror all 對應id的使用者沒找到 asdfasdf

新建d.js放入公用的

result_code定義

/**

* @apidefine result_code

* @apisuccess (警告resultcode) 20007 aa啊啊啊啊

* @apisuccess (警告resultcode) 20004 bbbbb

* @apisuccess (警告resultcode) 11000 ccccc

* @apisuccess (警告resultcode) 10021 fdddddddd

* @apisuccess (警告resultcode) 10020 eeeeeeeee

* @apisuccess (警告resultcode) 10024 ssssccccc

* @apisuccess (警告resultcode) 20020 mmmmm

* */

四、apigroup使用中文

//group = group.replace(/[^\w]/g, '_');即可

五、執行命令

六、注意如果亂碼

把建的js檔案 例如c.js以utf-8儲存

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

apidoc在您的源 中通過建立api注釋從而生成api說明文件。我們以express的專案為例 1 建立apidoc.json 2 我們在routes資料夾下建立api資料夾,用於書寫介面注釋說明,例如 api news newscontent 新聞詳情 apiversion 1.0.0 apin...

自動生成apidoc介面文件

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