postman最全中文图解使用文档

POSTMAN最全中文图解使用文档2018.4安装与更新安装：首先下载安装POSTMAN，打开POSTMAN官方网站，根据需求下载MAC/WINDOWS/LINUX版本的POST应用程序。更新：一般打开POSTMAN的原生应用程式会在应用程式重新载入或启动时检查更新。该应用程序将显示更新日志，提示您更新应用程序。总体内容发送api请求环境和变量设置脚本编写集合操作Api文档操作认识PostMan模拟服务器认识POSTMAN什么是POSTMAN？它有什么用？Postman是一款功能强大的网页调试与发送网页HTTP请求的Chrome插件。用户在开发或者调试网络程序或者是网页B/S模式的程序的时候是需要一些方法来跟踪网页请求的，用户可以使用一些网络的监视工具比如著名的Firebug等网页调试工具。今天给大家介绍的这款网页调试工具不仅可以调试简单的css、html、脚本等简单的网页基本信息，它还可以发送几乎所有类型的HTTP请求！Postman在发送网络HTTP请求方面可以说是Chrome插件类产品中的代表产品之一。当开发人员需要调试一个网页是否运行正常，并不是简简单单地调试网页的HTML、CSS、脚本等信息是否运行正常，更加重要的是网页能够正确是处理各种HTTP请求，毕竟网页的HTTP请求是网站与用户之间进行交互的非常重要的一种方式，在动态网站中，用户的大部分数据都需要通过HTTP请求来与服务器进行交互。Postman插件就充当着这种交互方式的“桥梁”，它可以利用Chrome插件的形式把各种模拟用户HTTP请求的数据发送到服务器，以便开发人员能够及时地作出正确的响应，或者是对产品发布之前的错误信息提前处理，进而保证产品上线之后的稳定性和安全性。在Chrome中安装了Postman插件以后，用户只需要在调试网站的时候启动Postman插件来进行几项简单的配置就可以实现对该网站的基本信息修改和发送各种类型的HTTP到该网站中，用户在发送HTTP数据的时候可以在编写相关测试数据的时候加入一定量的参数信息让测试数据更加准确，而这一切Postman都会完美地支持。开发人员在使用Postman的时候也许需要经常调试同一个网站或者是同时调试多个网站，如果每次打开Postman插件都要重新设置一遍那样会显得非常麻烦，Postman也考虑到用户的这一个性化需求，所以在Postman的配置页面中，用户可以添加或者管理多个网站用户启动Postman的时候就能自动打开相应的设置。POSTMAN界面布局postman界面分为两部分：左边的sidebar右边的requestbuilder：快速创建几乎所有的请求HTTP请求的4部分:URL，请求的method，headers，body。详情参考界面布局发送API请求在构建请求时，您将与请求主体编辑器一起工作。PostMan可以发送几乎任何类型的HTTP请求。身体编辑器分为4个区域，根据身体类型有不同的控制。关于标题的注意事项：当您通过HTTP协议发送请求时，您的服务器可能会期待一个Content-Type头。Content-Type头允许服务器正确解析正文。对于表单数据和urlencoded主体类型，Postman会自动附加正确的Content-Type头，因此您不必设置它。当您选择格式化类型时，将设置原始模式标题。如果您手动使用Content-Type标头，则该值优先于Postman设置。Postman没有为二进制体类型设置任何头类型。REQUESTREQUESTREQUESTBuilder在“Builder”选项卡下，请求构建器允许您快速创建任何类型的HTTP请求。HTTP请求的四个部分是URL，方法，标头和主体。PostMan为您提供工具来处理这些部分。REQUESTURL是您为请求设置的第一件事。URL输入字段存储先前使用的URL，并在您开始输入URL时显示自动完成下拉列表。单击Params按钮打开用于输入URL参数的数据编辑器。您可以单独添加键值对，Postman将组合上述查询字符串中的所有内容。如果您的网址已经具有参数-例如，如果您粘贴了其他来源的网址，Postman会将网址自动分割成对。注意：您在URL栏或数据编辑器中输入的参数不会自动进行URL编码。右键单击所选文本，然后选择“EncodeURIComponent”手动编码参数值。注意：http://如果没有指定协议，Postman将自动添加到URL的开头。REQUESTCookie可以使用Cookie管理器编辑与每个域相关联的Cookie，可以在本机应用程序中管理Cookie。要打开模式，请单击发送按钮下的Cookies链接。进一步了解如何管理Cookie。REQUESTHeaderpresets您可以在标题预设中将常用标题保存在一起。根据头选项卡，您可以通过选择“Managerpresets”从头预设添加到您的请求预设右侧下拉列表。REQUESTHeaders单击标题选项卡将显示标题键值编辑器。您可以将任何字符串设置为头名称。自动完成下拉列表将在您输入字段时提供常见HTTP标头的建议。“Content-Type”标题的值也可以在自动完成的下拉列表中使用。REQUESTMethod使用控件下拉列表可以直接更改请求方法。请求Body编辑器区域将根据方法是否可以附加Body而改变。在构建请求时，您将与请求主体编辑器一起工作。PostMan可以发送几乎任何类型的HTTP请求。Body编辑器分为4个区域，根据身体类型有不同的控制。关于标题的注意事项：当您通过HTTP协议发送请求时，您的服务器可能会期待一个Content-Type头。Content-Type头允许服务器正确解析正文。对于表单数据和urlencoded主体类型，Postman会自动附加正确的Content-Type头，因此您不必设置它。当您选择格式化类型时，将设置原始模式标题。如果您手动使用Content-Type标头，则该值优先于Postman设置。Postman没有为二进制体类型设置任何头类型。请求体（UrlBody）REQUESTREQUESTmultipart/form-data是Web表单用于传输数据的默认编码。这样可以模拟在网站上填写表单，并提交表单。表单数据编辑器可以为数据设置键值对（使用数据编辑器）。您也可以将文件附加到密钥。注意：由于HTML5规范的限制，文件不会存储在历史记录或集合中。下次发送请求时，您将需要再次选择该文件。不支持使用自己的Content-Type上载多个文件。Form-dataREQUEST此编码与URL参数中使用的编码相同。您只需要输入键值对，Postman会正确地对键和值进行编码。请注意，您无法通过此编码模式上传文件。形式数据和urlencoded之间可能会有一些混淆，所以请务必先检查一下你的API。urlCodeREQUESTraw原始请求可以包含任何内容。除了替换环境变量，PostMan不会触及在原始编辑器中输入的字符串。无论您放在文本区域中是否发送请求。原始编辑器可让您设置格式化类型以及您应该使用原始主体发送的正确标题。您也可以手动设置Content-Type标题，这将覆盖Postman定义的设置。在编辑器类型中选择XML/JSON可以为您的请求体提供语法突出显示，并设置Content-Type头。提示：在编辑器中选择文本并按CMD/CTRL+B可以自动对XML/JSON内容进行美化。REQUESTbinary二进制数据允许您发送无法在Postman中输入的内容，例如图像，音频或视频文件。您也可以发送文本文件。如前面在表单数据部分所述，如果要通过历史记录或集合加载请求，则必须重新连接文件。RESPONSE确保API响应正确是您在使用API​​时会做很多工作。PostMan回复查看器将使您的这个任务更容易。API响应由主体，标题和状态代码组成。PostMan在不同的标签中组织正文和标题。状态代码与完成API调用所需的时间一起显示在选项卡旁边。您可以将鼠标悬停在状态代码上，以获取有关代码的更多详细信息。大多数情况下，它将是HTTP规范规定的默认描述，但是API作者也可以添加自定义消息。RESPONSERESPONSESaveResponse如果请求已保存在集合中，则可以保存该请求的响应。一旦返回响应，单击保存响应按钮。输入名称以呼叫保存的响应。保存在请求中的所有响应将在您加载请求时作为example提供。单击右上角的“examples”下拉列表以查看并选择保存的示例。RESPONSE查看responsePostManBody标签为您提供了几个工具来帮助您快速了解事物。Body可以在三个视图中看到-Pretty，Raw和Preview。PrettyRESPONSEPretty的模式可以格式化JSON或XML响应，以便更容易查看。没有人想滚动一个最小的单行JSON响应寻找那个难以捉摸的字符串！突出显示漂亮模式中的链接，点击它们可以使用链接URL在Postman中加载GET请求。对于导航大响应，单击左侧的向下三角形（▼）以折叠大部分响应。要使PostMan自动格式化Body，请确保返回适当的Content-Type标题。如果API不这样做，那么您可以强制使用JSON或XML进行格式化。您可以通过从“detectionlanguage”下拉菜单中选择“JSON”，在“Setting”模式的“General”选项卡下强制使用JSON格式。在响应中查找项目：可以使用CMD/CTRL+F打开搜索栏，然后使用CMD/CTRL+G滚动结果。RESPONSERaw原始视图只是一个响应体的大文本区域。它可以帮助您判断您的回应是否缩小。RESPONSEPreview预览选项卡会在沙盒iframe中呈现响应。一些Web框架默认情况下返回HTML错误，预览模式在这里特别有用。由于iframe沙盒限制，JavaScript和图像在iframe中被禁用。您可以最大化body占据整个postman窗口。如果你打算花费大量的时间来应对这个问题，那就是要走的路。如果您的API端点返回图像，Postman将自动检测并呈现。对于二进制响应类型，您应该选择“Sendanddownload”，这将使您将响应保存到硬盘。然后，您可以使用适当的查看器查看它。这使您可以灵活地测试音频文件，PDF，zip文件或API抛出的任何内容。RESPONSEHeadersHeaders在“Headers”选项卡下显示为键值对。悬停在标题名称上可以根据HTTP规范给出对标题的描述。如果您发送HEAD请求，Postman将默认显示Headers标签。RESPONSEResponseTImeResponseSizePostMan自动计算响应从服务器到达所花费的时间。这对于性能的一些初步测试是有用的。PostMan将响应大小分解为正文和标题。响应大小是近似值。Response状态RESPONSECookie服务器发送的Cookie可在专用选项卡中显示。要在Postman中管理本地应用程序的Cookie，请使用管理COOKIES模式。如果您在PostmanChrome应用程序中工作，可以使用Interceptor扩展来帮助管理Cookie。Tests除了从请求的服务器获得的所有内容之外，还可以查看针对请求运行的测试的结果。了解更多有关Postman测试的信息。HISTORYHISTORY您使用PostMan发送的所有请求均存储在您可以使用左边栏访问的历史记录(history)中。历史可让您快速尝试各种请求，而不会浪费时间从头开始构建请求。您可以通过单击请求名称来加载先前的请求。如果您创建一个帐户并登录到PostMan，您的历史记录将与我们的服务器同步，实时备份，并可在您的设备上检索。如果您退出您的PostMan帐户，然后重新登录，最后10个请求将保留在您的历史记