摘要：使用開(kāi)發(fā)小說(shuō)接口服務(wù)一版本技術(shù)棧使用。接口用追書(shū)神器。目前接口設(shè)計(jì)有首頁(yè)，小說(shuō)詳情頁(yè)，搜索，小說(shuō)文章列表頁(yè)，排行。搜索接口版本的搜索接口只取前條數(shù)據(jù)，可以模糊查詢(xún)。取前條，并添加圖片鏈接請(qǐng)求出錯(cuò)了請(qǐng)傳入?yún)?shù)訪(fǎng)問(wèn)遮天就可以看到返回的數(shù)據(jù)了。

1.0版本技術(shù)棧使用express-generator、express、request、morgan、file-stream-rotator。接口用追書(shū)神器API。
目前接口設(shè)計(jì)有首頁(yè)，小說(shuō)詳情頁(yè)，搜索，小說(shuō)文章列表頁(yè)，排行API。

先創(chuàng)建一個(gè)倉(cāng)庫(kù)放文件

然后克隆創(chuàng)建好的倉(cāng)庫(kù)

git clone https://github.com/lanpangzhi/novel-api.git

npm install -g express-generator

然后再之前克隆倉(cāng)庫(kù)的上一級(jí)目錄執(zhí)行

express --no-view novel-api
cd novel-api
npm install 
npm install request file-stream-rotator -S
// Linux MacOS
DEBUG=novel-api:* & npm start
// windows 
set DEBUG=novel-api:* & npm start

生成好的目錄結(jié)構(gòu)和文件

打開(kāi)項(xiàng)目根目錄app.js,放在路由上面。

app.all("*", function (req, res, next) {
    res.header("Access-Control-Allow-Origin", "*");
    res.header("Access-Control-Allow-Headers", "Origin, X-Requested-With, Content-Type, Accept");
    res.header("Access-Control-Allow-Methods", "PUT,POST,GET,DELETE,OPTIONS");
    res.header("X-Powered-By", " 3.2.1")
    res.header("Content-Type", "application/json;charset=utf-8");
    next()
});

按時(shí)間分割log日志并寫(xiě)入本地磁盤(pán)，需要在app.js文件中引入fs和file-stream-rotator模塊。

let fs = require("fs"); 
let FileStreamRotator = require("file-stream-rotator");  // 日志按時(shí)間分割模塊

// 下面代碼寫(xiě)在var app = express();下面
let logDir = path.join(__dirname, "log");

// 檢查是否存在logDir這個(gè)目錄沒(méi)有則創(chuàng)建
fs.existsSync(logDir) || fs.mkdirSync(logDir);

// 日志分割流
let accessLogStream = FileStreamRotator.getStream({
    date_format: "YYYYMMDD",
    filename: path.join(logDir, "access-%DATE%.log"),
    frequency: "daily",
    verbose: false
});

// 日志中間件
app.use(logger("combined", { stream: accessLogStream }));

項(xiàng)目根目錄創(chuàng)建common文件夾，再里面再新建一個(gè)common.json文件

{
    "API": "http://api.zhuishushenqi.com",
    "PIC": "http://statics.zhuishushenqi.com",
    "CHAPTER": "http://chapter2.zhuishushenqi.com"
}

API域名: http://api.zhuishushenqi.com
圖片域名: http://statics.zhuishushenqi.com
章節(jié)域名: http://chapter2.zhuishushenqi...

1.0版本首頁(yè)接口直接返回最熱榜前20條數(shù)據(jù)。
修改app.js 文件路由中間件配置

app.use("/index", indexRouter);

修改routes/index.js 文件

let express = require("express");
let request = require("request");
let common = require("../common/common.json"); // 引用公共文件
let router = express.Router();

/** 
  首頁(yè)數(shù)據(jù)追書(shū)最熱榜 Top100
  獲取單一排行榜
  http://api.zhuishushenqi.com/ranking/{rankingId}
*/
router.get("/", function(req, res, next) {
  // 請(qǐng)求追書(shū)最熱榜 Top100
  request.get(`${common.API}/ranking/54d42d92321052167dfb75e3`, function (error, response, body) {
    if (error){
      res.send(JSON.stringify({"flag": 0, "msg": "請(qǐng)求出錯(cuò)了..."}));
    }
    
    // 解析返回?cái)?shù)據(jù)取前20條，并添加圖片url鏈接
    body = JSON.parse(body);

    if (body.ok){
      let books = body.ranking.books.slice(0, 19);
      books.forEach(element => {
        element.cover = common.PIC + element.cover;
      });

      res.send(JSON.stringify({ "flag": 1, "books": books, "msg": "OK" }));
    }else{
      res.send(JSON.stringify({ "flag": 0, "msg": "rankingId有問(wèn)題" }));
    }  
  });
});

module.exports = router;

訪(fǎng)問(wèn)http://localhost:3000/index 就可以看到返回的數(shù)據(jù)了。

1.0版本的搜索接口只取前40條數(shù)據(jù)，可以模糊查詢(xún)。
修改app.js 文件路由中間件配置，把users刪掉。

let searchRouter = require("./routes/search");
app.use("/search", searchRouter);

然后把routes文件夾下面的users.js刪除，新建search.js

let express = require("express");
let request = require("request");
let common = require("../common/common.json"); // 引用公共文件
let router = express.Router();

/** 
  模糊搜索接口
  返回模糊搜索前40條數(shù)據(jù)
  http://api.zhuishushenqi.com/book/fuzzy-search?query={name}
*/
router.get("/", function(req, res, next) {
  // 判斷query參數(shù)有沒(méi)有傳遞過(guò)來(lái)
  if (req.query.query){
    // req.query.query 編碼轉(zhuǎn)義
    let query = encodeURIComponent(req.query.query);
    request.get(`${common.API}/book/fuzzy-search?query=${query}`, function (error, response, body) {
      if (error){
        res.send(JSON.stringify({ "flag": 0, "msg": "請(qǐng)求出錯(cuò)了..." }));
      }

       // 解析返回?cái)?shù)據(jù)
      body = JSON.parse(body);

      if (body.ok){
        if (body.books.length == 0){
          res.send(JSON.stringify({ "flag": 0, "msg": "沒(méi)有找到書(shū)籍，換個(gè)名字試試吧。" }));
        }
        
        // 取前40條，并添加圖片url鏈接
        let books = body.books.slice(0, 39);
        books.forEach(element => {
          element.cover = common.PIC + element.cover;
        });

        res.send(JSON.stringify({ "flag": 1, "books": books, "msg": "OK" }));
      }else{
        res.send(JSON.stringify({ "flag": 0, "msg": "請(qǐng)求出錯(cuò)了..." }));
      }
    });
  }else{
    res.send(JSON.stringify({"flag": 0, "msg": "請(qǐng)傳入query參數(shù)"}));
  }
  
});

module.exports = router;

訪(fǎng)問(wèn)http://localhost:3000/search/?query=遮天 就可以看到返回的數(shù)據(jù)了。

https://github.com/lanpangzhi

http://blog.langpz.com

https://github.com/expressjs/morgan
https://juejin.im/entry/593a3fdf61ff4b006c737ca4
https://github.com/jianhui1012/bookreader/wiki/API-%E6%8E%A5%E5%8F%A3%E6%96%87%E6%A1%A3