一、简介
1.1 接口是什么
接口是 前后端通信的桥粱
简单理解:一个接口就是 服务中的一个路由规则,根据请求响应结果
接口的英文单词是AP1(Application Program Interface),所以有时也称之为 API 接口
这里的接口指的是『数据接口」,与编程语言(Java,G0 等)中的接口语法不同
1.2接口的作用
实现 前后端通信
1.3接口的开发与调用
大多数接口都是由 后端工程师 开发的,开发语言不限
般情况下接口都是由 前端工程师 调用的,但有时 后瑞工程师也会调用接口,比如短信接口,支付接口等
1.4接口的组成
一个接口一般由如下几个部分组成
- 请求方法
- 接口地址(URL)
- 请求参数
- 响应结果
一个接口示例https://www.free-api.com/doc/325
二、RESTfuI API
RESTfuIAP是一种特殊风格的接口,主要特点有如下几个:
- 操作资源要与 HTTP 请求方法 对应
- 操作结果要与 HTTP 响应状态码 对应
- URL 中的路径表示 资源,路径中不能有动词,例如 create,delete,update 等这些都不能有
规则示例:
操作 | 请求类型 | URL | 返回 |
---|---|---|---|
新增歌曲 | POST | /song | 返回新生成的歌曲信息 |
删除歌曲 | DELETE | /song/10 | 返回一个空文档 |
修改歌曲 | PUT | /song/10 | 返回更新后的歌曲信息 |
修改歌曲 | PATCH | /song/10 | 返回更新后的歌曲信息 |
获取所有歌曲 | GET | /song | 返回歌曲列表数组 |
获取单个歌曲 | GET | /song/10 | 返回单个歌曲信息 |
三、json-server
json·server 本身是一个 Js编写的工具包,I可以快速搭建 RESTfuI API 服务官方地址: https://github.com/typicode/json-server
操作步骤:
1.全局安装 json-server
npm i -g json-server
2.创建 JSON 文件(db.json),编写基本结构
3.以 JSON 文件所在文件类作为工作目录,执行如下命令
json-server --watch db.json
默认监听端口为 3000