3.postman与接口文档

Suyuoa

已于 2023-01-11 11:19:57 修改

阅读量1.9k

点赞数 1

分类专栏： Ajax笔记一些常用软件的操作文章标签： postman

于 2022-10-25 10:39:53 首次发布

本文链接：https://blog.csdn.net/potato123232/article/details/127508862

版权

一些常用软件的操作同时被 2 个专栏收录

18 篇文章 0 订阅

订阅专栏

Ajax笔记

16 篇文章 0 订阅

订阅专栏

数据接口简称接口，是被请求的url地址

1.3.5 发送带Authorization请求头的请求

1 postman

postman是接口测试工具，接口测试工具是用来模拟请求的，postman官网 Postman

1.1 下载

点开后会出现一个页面让你登录，登录之后就能用了

1.2 创建工作站

1.3 请求

1.3.1 工作站中创建请求

点击之后选择请求方式，输入你要访问的路由与要发送的数据，点击send后，在最下方会显示响应内容

1.3.2 带查询字符串的请求

post请求也可以带查询字符串请求

1.3.3 默认带参数的post请求

如果用post发送数据就要在Body中的x-www-form-urlencoded中填写数据

x-www-form-urlencoded是post默认的Content-Type

1.3.4 发送JSON的请求

1.3.5 发送带Authorization请求头的请求

在我们使用token的时候会使用到请求头 Authorization

使用Bearer Token不用把Bearer写在Token内容的开头

或者也可以放在 Headers 中发，在 Headers 中发就需要带Bearer 了

1.4 删除工作站

点击左上角可以查看我们当前已有的工作站

我们现在想把test这个工作站删掉，那么我们首先进入test工作站

点击Workspace Settings

点击Delete Workspace

输入工作站的名字，然后点击删除

这样test工作站就没有了

1.5 整理请求

当要测试一个项目的时候，接口量比较大，如果都堆在顶部会很不方便，这个时候我们可以使用collections功能

1.5.1 创建组

这样可以建立一个请求组，在铅笔图标的位置可以修改名字

1.5.2 删除组

这样是删除这个组

1.5.3 在组中添加请求

点击这里可以添加请求

可以在这里修改名字

1.5.4 将写好的请求保存到组中

之前通过加号添加的请求，想添加的组中，点击这里的save

选择要保存到的组

2 接口文档

接口文档是接口的说明文档，接口文档应该包含

接口名称
接口url
调用方式像GET、POST这些
参数格式包含参数名称，参数类型，是否必选，参数说明
响应格式接口的返回值情况，包含数据名称，数据类型，说明
返回示例

这个是接口文档的样子

这个是接口文档的md文件内容

# 图书列表
- 接口URL : http://www.liulongbin.top:3006/api/getbooks
- 调用方式 : GET
- 参数格式: 

|参数名称|参数类型|是否必选|参数说明|
|:----    |:---|:----- |-----   |
|id|Number|否|图书id|
|bookname|String|否|图书名称|
|author|String|否|作者|
|publisher|String|否|出版社|
- 响应格式: 

|数据名称|数据类型|说明|
|:----    |:---|:----- |
|status|Number|200成功;500失败|
|msg|String|对status字段的详细说明|
|data|Array|图书列表|
|+id|Number|图书id|
|+bookname|String|图书名称|
|+author|String|作者|
|+publisher|String|出版社|
- 返回示例 

``` 
{
    "status": 200,
    "msg": "获取图书列表成功",
    "data": [
        {
            "id": 1,
            "bookname": "西游记",
            "author": "吴承恩",
            "publisher": "北京图书出版社"
        },
        {
            "id": 2,
            "bookname": "红楼梦",
            "author": "曹雪芹",
            "publisher": "上海图书出版社"
        },
        {
            "id": 3,
            "bookname": "三国演义",
            "author": "罗贯中",
            "publisher": "北京图书出版社"
        }
    ]
}
```