带你了解 REST API
发布于 25 天前 作者 lvgithub 496 次浏览 来自 分享

带你了解REST API 的基本用法

源码地址 REST 的核心概念

  1. 互联网上所有可以访问的内容,都是资源。
  2. 服务器保存资源,客户端请求资源。
  3. 同一个资源,有多种表现形式。
  4. 协议本身不带有状态,通信时客户端必须通过参数,表示请求不同状态的资源。
  5. 状态转换通过HTTP动词表示。

具体操作类型–常用的HTTP动词有下面五个(括号里是对应的SQL命令)。

  1. GET(SELECT):从服务器取出资源(一项或多项)。
  2. POST(CREATE):在服务器新建一个资源。
  3. PUT(UPDATE):在服务器更新资源(客户端提供改变后的完整资源)。
  4. PATCH(UPDATE):在服务器更新资源(客户端提供改变的属性)。
  5. DELETE(DELETE):从服务器删除资源。

一些例子

  1. GET /posts:列出所有文章
  2. POST /posts:新建一篇文章
  3. GET /posts/ID:获取某篇指定文章的信息
  4. PUT /posts/ID:更新某篇指定文章的信息(提供该文章的全部信息)
  5. PATCH /posts/ID:更新某个指定动物园的信息(提供该文章的部分信息)
  6. DELETE /posts/ID:删除某篇文章
  7. GET /posts/ID/sections:列出某个文章的所有章节
  8. DELETE /posts/ID/sections/ID:删除某个指定动物园的指定动物

实验操作步骤 (1) 命令行进入rest-api目录,执行下面的命令。

 $ npm init -y
 $ npm install -S json-server 

(2) 在项目根目录下,新建一个 JSON 文件db.json。

{
  "posts": [
    { "id": 1, "title": "angular", "author": "cnode" }
  ],
  "comments": [
    { "id": 1, "body": "angular study commen", "postId": 1 }
  ],
  "profile": { "name": "cnode" }
}

(3) 打开package.json,在scripts字段添加一行。

"scripts": {
  "start": "json-server db.json",
   "test": "echo \"Error: no test specified\" && exit 1"
},

(4) 命令行下执行下面的命令,启动服务。

$ npm run start

!start.png

(5)查询数据(打开 Chrome 浏览器的 Postman 应用)

       1. [ get ] 向http://127.0.0.1:3000/posts        2. [ get ] 向http://127.0.0.1:3000/posts/1

查询所有文章 按照id查询文章

(6)添加数据

       1. [ post ] 向http://127.0.0.1:3000/comments,[注意,数据体Body要选择x-www-form-urlencoded编码,然后依次添加下面两个字段]

body: "i like angular"
postId: 1

       2. [ get ] 向http://127.0.0.1:3000/comments,查看所有评论 添加文章 查看所有评论


(7)修改数据

       1. [ put ] 向http://127.0.0.1:3000/comments/2,[注意,数据体Body要选择x-www-form-urlencoded编码,然后添加下面的字段]

body: "hello angulart"

       2. [ get ] 向http://127.0.0.1:3000/comments,查看修改后的结果

修改数据

(8)删除数据

       1.[ delete ] 向http://127.0.0.1:3000/comments/2

       2.[ get ] 向http://127.0.0.1:3000/comments查看结果 删除评论

1 回复

欢迎大家交流

回到顶部