我们使用AJAX请求数据时,被请求的URL地址,就叫做数据接口(接口),而每一个接口,都必须有请求方式(GET/POST)
就比如我们在上节博客中讲到的图书添加和获取,我们仔细观察不难看出,获取图书列表的接口(GET请求)和添加图书的接口(POST请求)是不一样的
http://www.liulongbin.top:3006/api/getbooks这是获取图书的接口
http://www.liulongbin.top:3006/api/addbook这是添加图书的接口
目录
我们理解了什么是接口,接下来我们再来了解一下接口文档:
一.接口文档
接口文档就是接口的说明文档,它是我们调用接口的依据,好的接口文档包含了URL,参数,输出内容的说明,使我们查阅接口文档就知道接口的作用以及接口如何进行调用
接口文档可以包含很多的信息,也可以精炼一点,但是一个合格的接口文档,应该有以下6种,为接口的调用提供依据
接口文档的组成部分:
1.接口名称:用来标识各个接口的简单说明
2.接口URL:接口的调用地址
3.调用方式:GET/POST等
4.参数格式:接口需要传递的参数,每个参数必须包含参数名称,参数类型以及参数说明,是否必选
5.响应格式:接口返回值的详细描述,一般包含数据名称,数据类型,参数说明
6.【返回示例】:通过对象的形式,举例服务器返回数据的结构
//返回示例
{
status: 200,
msg: "获取图书列表成功",
data: [
{id: 1, bookname: "西游记", author: "吴承恩", publisher: "北京图书出版社"},
{id: 2, bookname: "红楼梦", author: "曹雪芹", publisher: "上海图书出版社"},
{id: 3, bookname: "三国演义", author: "罗贯中", publisher: "北京图书出版社"}
]
}
二.接口测试工具(postman)
我们为了验证接口是否被正常访问,我们常常需要使用接口测试工具,对数据接口进行检测
这样可以让我们在不写任何代码的情况下,对接口进行调用和测试
具体软件操作我们不做详细的解释
我们推荐俩款测试工具:Postman(GitHub有汉化包,可自行下载),ApiPost(国产)
在这里我附上俩张Postman的测试图,就是测试我们上节博客讲到的图书管理:
我们在输入框左侧可以选择接口方式,输入URL地址之后,点击 Send 按钮开始请求
在下方的Params可以输入指定的键值,相当于[date],可以请求到相对应的数据
接下来就是POST请求,和GET请求类似,我们可以实现添加图书的功能
学习前端,关注小蜗