專案地址為：
專案地址

這個是自動生成網頁，我們就可以擺脫excel。
一.首先是使用node安裝apiDoc

npm install apidoc -g

二.在需要生成介面的添加註釋

/**
 * @api {post} /v1/login 使用者登入
 * @apiDescription 使用者登入
 * @apiName login
 * @apiGroup User
 * @apiParam {string} username 使用者名稱
 * @apiParam {string} password 密碼
 * @apiSuccess  token 返回token
 * @apiSuccessExample
 
 {json} Success-Response:
 *  {"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImhleGlhbmd5dSIsImV4cCI6MT
 * UyNjk3MzYwNSwiaWF0IjoxNTI2MzY4ODA1fQ.mvxQV2v7Wsyd_geZC6WqgZgb8WyUdh8M_G-Rpe6HrP4"}
 * @apiSampleRequest http://localhost:3001/v1/login
 * @apiVersion 1.0.0
 */

/**
 * @api {post} /v1/user 獲取使用者資訊
 * @apiDescription
 
 獲取使用者資訊
 * @apiName user
 * @apiGroup User
 * @apiParam {string} username 使用者名稱
 * @apiParam {string} age 年齡
 * @apiParam {string} token 簽名
 * @apiSuccess  token 返回token
 * @apiSuccessExample {json} Success-Response:
 *  {"token":""}
 * @apiSampleRequest http://localhost:3001/v1/user
 * @apiVersion 1.0.0
 */
 

三.專案目錄配置建立apidoc.json檔案

{
    "name": "cloud-server",
    "version": "1.0.0",
    "description": "cloud-server專案API文件",
    "title": "cloud-server API",
    "url": "http://localhost:3030/v1",
    "forceLanguage": "zh-cn"
  }

或者在package.json檔案中加

,
  "apidoc": {
    "name": "cloud-server",
    "version": "1.0.0",
    "description": "cloud-server專案API文件",
    "title": "cloud-server API",
    "url": "http://localhost:3030/v1",
    "forceLanguage": "zh-cn"
  }

name：專案名稱
version：專案版本
description：專案介紹
title：瀏覽器顯示的標題內容
url：endpoints的字首，例如https://api.github.com/v1
sampleUrl：如果設定了，則在api文件中出現一個測試用的from表單
header
title：導航文字包含header.md檔案
filename：markdown-file 檔名
footer
title：導航文字包含header.md檔案
filename：markdown-file 檔名
order：用於配置輸出 api-names/group-names 排序，在列表中的將按照列表中的順序排序，不在列表中的名稱將自動顯示。

四.使用命令生成專案目錄中介面的目錄是routes，生成的今天網頁我是放在了public/apidoc下

apidoc -i ./routes/  -o ./public/apidoc

   var token = req.body.token || req.query.token || req.headers['x-access-token'];