Postman的使用教程以及常见报错

墨蓝 2023-02-15 10:28 24阅读 0赞

postman是一个功能强大的可以发送Http请求和接口调试的一个工具。

这里看到的是工具，而不是插件（如果你看到资料是“插件”的话，实际说明这个资料有点年头了，或者说作者是抄别人的，现在百度很多站点的各种教程都是同一个文章一大堆人发布。但是好在里面很多东西都没有变，都是可以用的。添加我自己的私货，公众号：我是坑货）

因为目前使用最多的工具，chrome插件貌似不怎么更新，单独出了一个这样的程序来帮助开发调试。有点像Soap UI那样，但是不同的是我们用soapUI通常是webService用到的来调试的。而调试接口这方面明显postman更好用一些。

### 目录 ###

*  一 下载
 *  二 postman设置
 *  三，postman使用
 *  四 快捷健使用
 *  五 常见报错

# 一 下载 #

首先现在下载要注册登陆了，就是你直接下载工具也会提醒你去登陆，没有就注册一个去。

[postman下载地址][postman]

# 二 postman设置 #

首先这个工具下载下来没啥要设置的，基本就是开箱即用，非要说有什么注意，就是postman也可以设置主题（现在好多软件都支持，我比较喜欢暗黑模式不费眼睛，白色的盯太久确实容易累。），在settings里面可以设置

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0ZlaUNoYW5nV3VSYW8_size_16_color_FFFFFF_t_70]

主题选择

# 三，postman使用 #

这部分其实就有很多可以说的细节

（1）创建request和collection（非必要）

首先你可能要创建一个request或者collection，为什么要这么说可能呢？因为你直接在大的窗口“+”一个，也可以测试，你要是save就会告诉你创建一个request，让你填一些信息进去。

只不过是request是类似于给你创建的接口定义一下，collection类似于一个文件夹，可以把request分门别类放在不同的collection下面

（2）填写请求参数

这个是很重要的一部，实际上有些接口不需要鉴权不需要参数输入一个地址，选择一下发送方式是get还是post就可以了。

但实际真正开发的时候不一样，首先你要看对应的接口文档需要啥参数，以及你的接口鉴权方式，要不要token，要不要先登录接口调通才能后续操作。

这里要注意的是参数的填写，首先你要知道你参数提交的方式，是放在head里面，还是body里面，即使是放在body里面也要知道是form表单提交还是json字符串或者是二级制。

fom-data表单提交，非常常见，输入要填写的参数，按照接口的要求的来填写基本就没问题，当然前提是你要确定是不是form表单，以及文档靠不靠谱。

这里一张截图。因为接口的方式是application/json，所以最后方式是json形式，之所以选择raw就是表示可以上传任意版本的文本，不管是json，text，xml都可以（反正我们最后选择了文本形式了。），选择这个把你的参数形式放进去就行，如果是Json就\{ “XXX” ：xxx \}这种json形式的文本就可以了。

另外几种其实相对来说比较受限而且少见，比如x-www-from-urlencoded是在application/x-www-from-urlencoded下面才使用的。

binary二进制形式的。

GraphQL 是一种针对 Graph（图状数据）进行查询特别有优势的 Query Language（查询语言），貌似树形结构什么的很有优势，facebook在用，具体我也没见过。

根据不同的body形式要求选择，一般来是form和文本形式的raw最常见。（我的公众号：我是坑货 我的博客：http://treasureboyzp.cn/）

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0ZlaUNoYW5nV3VSYW8_size_16_color_FFFFFF_t_70 1]  
body的选择

# 四 快捷健使用 #

作为一个IDE工具，快捷健肯定是少不了的，这里找到一个博客介绍postman快捷键的，比较好的是他是mac系统和windows系统都有。  
[postman快捷健][postman 1]

当然这里我觉得用的最多的运行  
crtl + enter  
打开新标签  
crtl + T  
切换选项卡  
crtl + shift +\[ 或者 crtl + shift + \]  
以上的切换的快捷健无效，真正切换的标签卡片的是crtl+tab（这个应该是很多IDE默认切换前后的快捷键了）  
美化请求原文  
crtl +B  
关闭标签  
crtl + w

# 五 常见报错 #

感觉自己配置好的时候，第一次跑经常会报错，大概如下：

{
        "code": "XXXXX",
        "message": "请确认您请求的MediaType是否正确",
        "success": false,
        "data": null
    }

实际上不同的框架可能设置的报错信息不同，但是你第一个想到的就是你的text格式选对了没，比如你要的是application/json，但是你没有选对应的setting模式就会报错，其实这是你没注意，或者马虎没注意造成的

application/json格式正确选择setting为：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0ZlaUNoYW5nV3VSYW8_size_16_color_FFFFFF_t_70 2]

资料：

[官网][Link 1]  
[一份比较旧的，但是还是参考意义的文档][Link 2]

我的公众号：我是坑货  
我的博客：http://treasureboyzp.cn/

[postman]: https://www.postman.com/downloads/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0ZlaUNoYW5nV3VSYW8_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20200605112206426.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0ZlaUNoYW5nV3VSYW8=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0ZlaUNoYW5nV3VSYW8_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20200605112230410.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0ZlaUNoYW5nV3VSYW8=,size_16,color_FFFFFF,t_70
[postman 1]: https://www.cnblogs.com/qican/p/11699732.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0ZlaUNoYW5nV3VSYW8_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20200611204343549.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0ZlaUNoYW5nV3VSYW8=,size_16,color_FFFFFF,t_70
[Link 1]: https://www.postman.com/
[Link 2]: https://www.jianshu.com/p/97ba64888894