[TOC] ## REQUEST 在构建请求时，您将与请求主体编辑器一起工作。Postman可以发送几乎任何类型的HTTP请求。身体编辑器分为4个区域，根据身体类型有不同的控制。 关于标题的注意事项：当您通过HTTP协议发送请求时，您的服务器可能会期待一个Content-Type头。Content-Type头允许服务器正确解析正文。对于表单数据和urlencoded主体类型，Postman会自动附加正确的Content-Type头，因此您不必设置它。当您选择格式化类型时，将设置原始模式标题。如果您手动使用Content-Type标头，则该值优先于Postman设置。Postman没有为二进制体类型设置任何头类型。 ### Builder 在“ Builder”选项卡下，请求构建器允许您快速创建任何类型的HTTP请求。HTTP请求的四个部分是URL，方法，标头和主体。PostMan为您提供工具来处理这些部分。 URL是您为请求设置的第一件事。URL输入字段存储先前使用的URL，并在您开始输入URL时显示自动完成下拉列表。 单击 Params按钮打开用于输入URL参数的数据编辑器。您可以单独添加键值对，Postman将组合上述查询字符串中的所有内容。如果您的网址已经具有参数 - 例如，如果您粘贴了其他来源的网址，Postman会将网址自动分割成对。 >[warning] 您在URL栏或数据编辑器中输入的参数不会自动进行URL编码。右键单击所选文本，然后选择“EncodeURIComponent”手动编码参数值。 >[warning] http://如果没有指定协议， Postman将自动添加到URL的开头。 ### Cookie 可以使用Cookie管理器编辑与每个域相关联的Cookie，可以在本机应用程序中管理Cookie。要打开模式，请单击  发送  按钮 下的Cookies 链接  。进一步了解如何管理Cookie。  ### Header presets 您可以在标题预设中将常用标题保存在一起。根据头选项卡，您可以通过选择“Manager presets”从头预设添加到您的请求预设右侧下拉列表。  ### Headers 单击标题选项卡将显示标题键值编辑器。您可以将任何字符串设置为头名称。自动完成下拉列表将在您输入字段时提供常见HTTP标头的建议。“Content-Type”标题的值也可以在自动完成的下拉列表中使用。  ### Method 使用控件下拉列表可以直接更改请求方法。请求Body编辑器区域将根据方法是否可以附加Body而改变。  ### 请求体（Url & Body） 在构建请求时，您将与请求主体编辑器一起工作。Postman可以发送几乎任何类型的HTTP请求。Body编辑器分为4个区域，根据身体类型有不同的控制。 关于标题的注意事项：当您通过HTTP协议发送请求时，您的服务器可能会期待一个Content-Type头。Content-Type头允许服务器正确解析正文。对于表单数据和urlencoded主体类型，Postman会自动附加正确的Content-Type头，因此您不必设置它。当您选择格式化类型时，将设置原始模式标题。如果您手动使用Content-Type标头，则该值优先于Postman设置。Postman没有为二进制体类型设置任何头类型。 * Form-data multipart/form-data是Web表单用于传输数据的默认编码。这样可以模拟在网站上填写表单，并提交表单。表单数据编辑器可以为数据设置键值对（使用数据编辑器）。您也可以将文件附加到密钥。注意：由于HTML 5规范的限制，文件不会存储在历史记录或集合中。下次发送请求时，您将需要再次选择该文件。 不支持使用自己的Content-Type上载多个文件。  * xxx-www-form-urlencode 此编码与URL参数中使用的编码相同。您只需要输入键值对，Postman会正确地对键和值进行编码。请注意，您无法通过此编码模式上传文件。形式数据和urlencoded之间可能会有一些混淆，所以请务必先检查一下你的API。 * RAW 原始请求可以包含任何内容。除了替换环境变量，PostMan不会触及在原始编辑器中输入的字符串。无论您放在文本区域中是否发送请求。原始编辑器可让您设置格式化类型以及您应该使用原始主体发送的正确标题。您也可以手动设置Content-Type标题，这将覆盖Postman定义的设置。在编辑器类型中选择XML / JSON可以为您的请求体提供语法突出显示，并设置Content-Type头。 提示： 在编辑器中选择文本并按CMD / CTRL + B 可以自动对XML / JSON内容进行美化。  * Binary 二进制数据允许您发送无法在Postman中输入的内容，例如图像，音频或视频文件。您也可以发送文本文件。如前面在表单数据部分所述，如果要通过历史记录或集合加载请求，则必须重新连接文件。  ## RESPONSE 确保API响应正确是您在使用API​​时会做很多工作。Postman回复查看器将使您的这个任务更容易。 API响应由主体，标题和状态代码组成。PostMan在不同的标签中组织正文和标题。状态代码与完成API调用所需的时间一起显示在选项卡旁边。您可以将鼠标悬停在状态代码上，以获取有关代码的更多详细信息。大多数情况下，它将是HTTP规范规定的默认描述，但是API作者也可以添加自定义消息。 * Save Response 如果请求已保存在集合中，则可以保存该请求的响应。一旦返回响应，单击保存响应按钮。输入名称以呼叫保存的响应。保存在请求中的所有响应将在您加载请求时作为example提供。单击右上角的“ examples”下拉列表以查看并选择保存的示例。这儿别的人员才查看时，可以方便的知道每种情况不同的响应内容。  * 查看Response PostMan Body标签为您提供了几个工具来帮助您快速了解事物。Body可以在三个视图中看到 - Pretty，Raw和Preview。  * Pretty Pretty的模式可以格式化JSON或XML响应，以便更容易查看。没有人想滚动一个最小的单行JSON响应寻找那个难以捉摸的字符串！突出显示漂亮模式中的链接，点击它们可以使用链接URL在Postman中加载GET请求。对于导航大响应，单击左侧的向下三角形（▼）以折叠大部分响应。 * Raw 原始视图只是一个响应体的大文本区域。它可以帮助您判断您的响应是否缩小。 * Preview 预览选项卡会在沙盒iframe中呈现响应。一些Web框架默认情况下返回HTML错误，预览模式在这里特别有用。由于iframe沙盒限制，JavaScript和图像在iframe中被禁用。 您可以最大化body占据整个postman窗口。如果你打算花费大量的时间来应对这个问题，那就是要走的路。 如果您的API端点返回图像，Postman将自动检测并呈现。对于二进制响应类型，您应该选择“Send and download”，这将使您将响应保存到硬盘。然后，您可以使用适当的查看器查看它。这使您可以灵活地测试音频文件，PDF，zip文件或API抛出的任何内容。 ## Cookie Postman的本机应用程序提供 `MANAGE COOKIES` 模式，允许您编辑与每个域关联的Cookie。 如果您在Postman Chrome应用程序中工作，可以使用`Interceptor`扩展来帮助管理Cookie。 ## Tests 除了从请求的服务器获得的所有内容之外，还可以查看针对请求运行的测试的结果。了解更多有关Postman 测试的信息。 ## HISTORY 您使用PostMan发送的所有请求均存储在您可以使用左边栏访问的历史记录(history)中。历史可让您快速尝试各种请求，而不会浪费时间从头开始构建请求。您可以通过单击请求名称来加载先前的请求。 如果您创建一个帐户并登录到PostMan，您的历史记录将与我们的服务器同步，实时备份，并可在您的设备上检索。如果您退出您的PostMan帐户，然后重新登录，最后10个请求将保留在您的历史记录中。Postman Pro和Enterprise用户将可以访问最近的100个请求。相同的政策适用于收集运行。请记住，您可以随时在收藏中保存尽可能多的请求。 ## Debugging and logs PostMan应用程序是PostMan厂家进行过广泛的测试和测试版本。也就是说，可能是应用程序崩溃或出现意外行为的情况。如果你一直无法  排除  在自己的问题，你可以在文件中的问题GitHub的跟踪，或访问PostMan支持中心  ，如果你想包含机密数据。将应用程序的控制台日志包含在报告中将提供一些有用的数据进行故障排除。  PostMan控制台类似于浏览器的开发者控制台，除了适用于API开发。如果API或API测试不符合您的期望，那么这将是您在调试时进行深度潜水的地方。只要控制台窗口打开，您的所有API活动将被记录在这里，以查看发生什么了事情。  PostMan控制台记录以下信息： 1. 发送的实际请求，包括所有底层请求标头和变量值等。 2. 由Postman处理服务器之前发送的确切响应 用于请求的代理配置和证书。 3. 来自测试或预请求脚本的错误日志 console.log()  在脚本中使用`console.info()`或`console.warn()`在适当的位置将有助于提取正在起作用的确切的代码行。 4. 如果你知道你`console.log() `在JavaScript的方式，这是相似的。 ## 授权（Authorization） 当请求编辑器强大到足以构建任何类型的请求时，有时您可能需要一些帮助。PostMan有“helper”，可以简化一些重复和复杂的任务。目前的助手让您轻松处理身份验证协议。您可以使用所有帮助器的环境变量。 您可以选择将帮助数据保存到收集请求。这将导致每次重新生成签名。这些助手甚至会在纽曼工作！ ## Generate code snippets(生成代码) 一旦您确定并将您的请求保存在Postman中，您可能希望从您自己的应用程序发出相同的请求。Postan可以让您以各种语言和框架生成代码段，从而帮助您执行此操作。您需要点击 蓝色发送按钮下的 代码链接打开GENERATE CODE SNIPPETS模式。  ## 代理 代理服务器充当内部网络和Internet之间的安全屏障，使Internet上的其他人无法访问内部网络上的信息。 Postman允许您配置自定义代理设置，指示Postman通过代理服务器转发您的HTTP或HTTPS请求。换句话说，这将通过您选择的代理服务器路由通过Postman应用程序发送的所有请求。