第十章

实战项目:RESTful API

构建一个图书管理 API

项目介绍

我们将构建一个简单的图书管理 API,使用 JSON 作为数据交换格式。 这个项目将展示 JSON 在前后端分离架构中的实际应用。

GET
获取列表
POST
添加图书
PUT
更新图书
DELETE
删除图书

API 端点设计

方法 路径 描述
GET /api/books 获取所有图书
GET /api/books/:id 获取单本图书
POST /api/books 添加新图书
PUT /api/books/:id 更新图书
DELETE /api/books/:id 删除图书

请求和响应示例

GET /api/books

// 响应
{
  "code": 0,
  "message": "请求成功",
  "data": [
    {
      "id": 1,
      "title": "JavaScript 高级程序设计",
      "author": "Nicholas C. Zakas",
      "year": 2011
    }
  ]
}

POST /api/books

请求体

{
  "title": "深入浅出 Node.js",
  "author": "朴灵",
  "year": 2013
}

响应

{
  "code": 0,
  "message": "创建成功",
  "data": {
    "id": 2,
    "title": "深入浅出 Node.js",
    "author": "朴灵",
    "year": 2013
  }
}