Postman官⽹教程，重点内容，翻译笔记,
json格式的提交数据需要添加：Content-Type ：application/x-www-form-urlencoded，否则会导致请求失败
1. 创建 + 测试：创建和发送任何的HTTP请求，请求可以保存到历史中再次执⾏
2. Organize: 使⽤Postman Collections为更有效的测试及集成⼯作流管理和组织APIs
3. document: 依据你创建的Clollections⾃动⽣成API⽂档，并将其发布成规范的格式
4. collarorate: 通过同步连接你的team和你的api，以及权限控制，API库
注意：如果在输⼊参数时，没有⾃动decode到URL中，则可以选中参数右键后，选择EncodeURIComponent（⼀般都会⾃动填充的）同样也可以decode，将参数⽣成dictionary的形式（⼀般都会⾃动填充的）：
有的URL中有path变量，postman可以⾃动提取该path变量为⼀个key
mutipart/form-data是⽹页表单⽤来传输数据的默认格式。可以模拟填写表单，并且提交表单。
urlencoded
同前⾯⼀样，注意，你不能上传⽂件通过这个编码模式。
该模式和表单模式会容易混淆。urlencoded中的key-value会写⼊URL，form-data模式的key-value不明显写⼊URL，⽽是直接提交。raw request可以包含任何东西。所有填写的text都会随着请求发送。
binary
image, audio or files 。也不能保存历史，每次选择⽂件，提交。
本地安装的Postman 优点,⽐较与⾕歌浏览器插件版本
1. Cookie 本机应⽤程序可让您直接使⽤Cookie。与Chrome应⽤不同，不需要单独的扩展。
2. 内置代理本机应⽤程序附带内置代理，可⽤于捕获⽹络流量。
3. 菜单栏 Chrome应⽤程序的菜单栏⾮常有限。使⽤本地应⽤程序，您可以创建集合，切换到历史请求等等！
4. 受限标题本地应⽤程序的最新版本允许您发送headers 如Origin和User-Agent。这些限制在Chrome
应⽤程式中
5. Postman控制台本地应⽤程序的最新版本还具有内置控制台，可让您查看API调⽤的⽹络请求详细信息
1. Sending Requests 发送请求
postman界⾯分为两个区域, 左侧的⼯具栏和右侧的请求⽣成器。
请求⽣成器允许您快速创建⼏乎任何类型的请求
HTTP请求的四个部分是URL，⽅法，标头和主体。
The four parts of an HTTP request are the URL, method, headers, and the body.
URL是您为请求设置的第⼀件事。
URL输⼊字段存储先前使⽤的URL，并在开始输⼊URL时显⽰⾃动完成下拉列表。
点击URL参数按钮将打开输⼊URL参数的键值编辑器。(参数按钮params)
在URL栏或键/值编辑器中输⼊的参数不会⾃动进⾏URL编码。
右键单击所选⽂本，然后单击EncodeURIComponent以⼿动编码参数值。
<；全选URL地址栏内容，然后右击, 可以进⾏编码和解码操作>.
(参数按钮params)
You can individually(单独) add key/value pairs and Postman will combine everything together.
您可以单独添加键/值对，Postman会将所有内容结合在⼀起。
如果您的⽹址已经具有参数 - 例如，如果您粘贴了其他来源的⽹址，Postman会将⽹址⾃动分割成对。
Common headers part of the HTTP spec are available
in an auto-complete drop down when you begin typing the header name.
Values for the “Content-Type” header are also available in an auto-complete drop down.
点击标题切换将显⽰标题键值编辑器。您可以将任何字符串设置为头名称。
当您开始键⼊标题名称时，HTTP规范的公共头⽂件可在⾃动完成下拉列表中使⽤。
“内容类型”标题的值也可以在⾃动完成的下拉列表中使⽤。
Restricted headers and cookies
受限的headers和Cookie
不幸的是，某些headers受Chrome和XMLHttpRequest规范限制。
以下标题被阻⽌：
Accept-Charset
Accept-Encoding
Access-Control-Request-Headers
Access-Control-Request-Method
Connection
Content-Length
Cookie
Cookie 2
Content-Transfer-Encoding
Date
Expect
Host
Keep-Alive
Origin
Referer
TE
Trailer
Transfer-Encoding
Upgrade
User-Agent
Via
通过点击Postman中的Interceptor切换或通过Chrome⽹上应⽤店来安装Interceptor扩展
安装完成后，再次点击该切换, 您现在可以发送使⽤这些标头的请求。
客户端版Postman，没有限制
====Cookies========postman的中文翻译
As the packaged app runs in a sandbox separately from the browser,
it can not access cookies set inside the browser.
This restriction can also be overcome using the Interceptor extension.
Postman routes all requests through the Interceptor,
which then uses the browser context to send requests.
Cookies set inside the browser are automatically attached to your requests.
随着打包的应⽤程序与浏览器分开运⾏在沙箱中，它⽆法访问浏览器中设置的Cookie。
这个限制也可以使⽤Interceptor扩展来克服。
Postman通过Interceptor路由所有请求，然后使⽤浏览器上下⽂发送请求。
浏览器中设置的Cookie会⾃动附加到您的请求中。
启⽤后，您也可以从Postman发送cookies。
只需设置“Cookie”标题，并且cookie将随请求⼀起发送。
您还可以访问返回响应时可⽤的Cookie。
=====Header presets==========
在header的右侧有个presets按钮，点击开有个 manage presets按钮.
您可以在标题预设中将常⽤标题保存在⼀起。
您可以通过单击“添加预设”按钮或从标题下拉列表中选择预设来为您的请求添加标题预置。
======Method========
Changing the method is straightforward.
Just select the method from the select control.
The request body editor area will change depending on whether the method can have a body attached to it or not.改变⽅法很简单。
只需从选择控件中选择该⽅法即可。
请求body⾝体编辑器区域将根据⽅法是否可以附加⾝体⽽改变.
添加其他⽅法和切换是否可以附加⾝体的功能将很快添加。
The ability to add additional methods and toggling whether a body can be attached to it will be added soon.
=====Request body======
While constructing requests, you would be dealing with the request body editor a lot.
Postman lets you send almost any kind of HTTP request (If you can't send something, let us know!).
The body editor is divided into 4 areas and has different controls depending on the body type.
1. form-data: 就是http请求中的multipart/form-data
multipart/form-data是Web表单⽤于传输数据的默认编码。
这样可以模拟在⽹站上填写表单，并提交表单。
表单数据编辑器允许您为数据设置键/值对（使⽤键值编辑器）。
您也可以将⽂件附加到密钥。
请注意，由于HTML5规范的限制，⽂件不会存储在历史记录或集合中。
在发送请求时，您必须再次选择该⽂件。
2. urlencoded未编码
x-www-form-urlencoded：
就是application/x-www-from-urlencoded，会将表单内的数据转换为键值对，⽐如,name=Java&age = 23
此编码与URL参数中使⽤的编码相同。
您只需要输⼊键/值对，Postman会正确地对键和值进⾏编码。
请注意，您⽆法通过此编码模式上传⽂件。
形式数据和urlencoded之间可能会有⼀些混淆，所以请务必先检查⼀下你的API。
3. raw 未加⼯的
原始请求可以包含任何内容。
除了替换环境变量，Postman不会触摸在原始编辑器中输⼊的字符串。
⽆论您放在⽂本区域中是否发送请求。
原始编辑器可让您设置格式化类型以及您应该使⽤原始主体发送的正确标题。
您也可以⼿动设置Content-Type头。
通常，您将在此发送XML或JSON数据。
4. binary ⼆进制
⼆进制数据允许您发送⽆法在Postman中输⼊的内容。
例如，图像，⾳频或视频⽂件。
您也可以发送⽂本⽂件。
如前⾯在表单数据部分所述，如果要通过历史记录或集合加载请求，则必须重新连接⽂件。
2. Understanding and working with responses
理解和使⽤响应
Ensuring that the API response is correct is something that you will be doing a lot.
The Postman response viewer will make this task much easier for you.
The status code with the time taken for the API call is displayed next to the tabs.
You can hover over(悬停) the status code to get more details about the code.
Mostly it will be the default description as mandated(规定) by the HTTP spec but API authors can also add custom messages. Saving responses
保存响应
If a request has been saved in a collection , you can save responses for that request.
Once the response has been received, click the “Save response” button.
You'll be able to save the response with a name.
All responses saved for a request will be available whenever you load the request (above the request URL).
Viewing responses
查看回应
The Postman body tab gives you several tools to help you make sense of things quickly.
The body can be viewed in one of three views - pretty, raw, and preview.
1. Pretty 漂亮
The pretty mode formats JSON or XML responses so that they are easier to look at.
Nobody wants to scroll through a minified single line JSON response looking for that elusive string!
Links inside the pretty mode are highlighted and clicking on them can load a GET request in Postman with the link URL.
By clicking on the line numbers on the left you can fold large chunks of the response.
For Postman to automatically format the body, make sure the appropriate Content-Type header is returned.
If the API does not do this then you can force formatting through JSON or XML.
You can enable the “Force JSON” setting as well.
Note: You can use Cmd+F / Ctrl+F to open the search bar, and Cmd+G / Ctrl+G to scroll through results.
A complete set of keyboard shortcuts can be found here.
通过点击左侧的⾏号，您可以折叠⼤块的响应.
要使Postman⾃动格式化⾝体，请确保返回适当的Content-Type标题
2. Raw 原⽣的
The raw view is just a big text area with the response body.
It can help to tell whether your response is minified or not.
3. Preview
预览
The preview tab renders the response in a sandboxed iframe.
Some web frameworks by default return HTML errors and the preview mode is especially helpful there.
Due to iframe sandbox restrictions, Javascript and images are disabled in the iframe.
You can maximize the body to occupy(使⽤) the whole Postman window.
In case, you plan on spending a lot of time with the response, this is the way to go.
If your API endpoint returns an image, Postman will detect and render it automatically.
For binary response types, you should select “Send and download” which will let you save the response to your hard disk. You can then view it using the appropriate viewer.
This gives you the flexibility to test audio files, PDFs, zip files or anything that the API throws at you.
4. response返回的Headers
Headers are displayed as key/value pairs in the header tab.
Hovering over the header name can give you a description of the header according to the HTTP spec.
If you are sending a HEAD request, Postman will show the headers tab by default.
5. Cookies
Postman v0.8.x can display browser cookies as it shares the same environment with the browser.
For the packaged app, you’ll need to enable the Interceptor.
You can then view response cookies in the “Cookies” tab of the response section.
Refer to the sandbox documentation for info on how to access cookies in the pre-request/test scripts
Postman 可以显⽰浏览器Cookie，因为它与浏览器共享相同的环境.
对于chrome浏览器的包类型的应⽤程序，您需要启⽤Interceptor
可以在响应部分的“Cookie”选项卡中查看响应Cookie
3. Authentication helpers
认证助⼿(授权)
While the request editor is powerful enough to construct any kind of requests, sometimes you might need some help. Postman has something called “helpers” which can simplify(简化) some repetitive(重复的) and complex(复杂) tasks.
The current set of helpers let you deal with authentication protocols easily.
You can use environment variables with all helpers.
⽬前的助⼿让您轻松处理⾝份验证协议。您可以使⽤所有帮助器的环境变量。
You can choose to save helper data to collection requests.
This will cause the signature to be regenerated each time.
These helpers will even work in Newman!
===Basic Auth 基本认证
username
password
Update Request
Enter the username and password fields and
hit “Update Request” to generate the authorization header.
输⼊⽤户名和密码字段，并点击“更新请求”⽣成授权头。
===Digest Auth 摘要认证
Digest auth is more complicated than basic auth
and
uses the values currently set in the request to generate the authorization header.
Make sure they are set properly before you generate the header.
Postman will remove the existing header if it's already present.
Digest auth⽐基本认证更复杂，
并使⽤当前在请求中设置的值来⽣成授权头。
在⽣成标题之前，请确保它们已正确设置。
如果已经存在，Postman将删除现有的标题。
===OAuth 1.0a (开放授权；⾝份验证；开放式验证)
Postman's OAuth helper lets you sign requests which support OAuth 1.0a based authentication.
Currently it does not let you acquire the access token.
That's something you would need from the API provider.
The OAuth 1.0 helper can set values in either the header or as query parameters.
⽬前不允许您获取访问令牌。token是.需要API提供商.
As subsequent(并发的；其次的) OAuth requests might expect a different nonce(随机的) value,
Postman can refresh the OAuth signature just before the request is sent if auto add parameters is enabled.
随着后续OAuth请求可能会期望不同的随机值，
Postman可以在发送请求之前刷新OAuth签名，如果启⽤了⾃动添加参数。
OAuth 1.0规范相当复杂，有很多变化。
Postman尽量⽀持尽可能多的这些变体，但如果某些内容不适合您，
请在Github上提出问题。这些是我们包括的⼏个选项：
将空参数添加到签名 - OAuth1.0的⼀些实现需要将空参数添加到签名中。
将参数添加到标题 - 如果启⽤，params将添加到标题。如果没有 - GET请求的URL参数，以及POST / PUT请求的请求体Access tokens are stored locally and will show up in the helper list.
To add an access token to the request, click the token name.
访问令牌存储在本地，并将显⽰在帮助列表中。
要向请求添加访问令牌，请单击令牌名称。
4. Requests History 请求历史记录
您使⽤Postman发送的所有请求均存储在您可以使⽤左边栏访问的历史记录中。
历史让您可以快速尝试各种请求，⽽不⽤浪费时间重新形成请求。
您可以通过单击请求名称来加载先前的请求。
如果您在Postman上创建⼀个帐户，
您的历史记录将与我们的服务器同步，
您将能够检索到跨设备，并始终备份。
同样适⽤于专业⽤户。
5. Using tabs to handle multiple requests
使⽤选项卡来处理多个请求
很多⽤户可能希望同时保持多个请求的打开。
标签功能可以让您做到这⼀点。
您发送的任何请求（及其响应）都位于该选项卡的本地，
您可以切换到其他选项卡，⽽不会丢失第⼀个响应。
当您在Collection侧栏中点击保存的请求时，请求将在您打开的选项卡中打开。
但是，如果在当前选项卡中打开的请求是脏的（标签页中的橙⾊点），则新的请求将在新选项卡中打开。
6. Using interceptor to read and write cookies
使⽤读写cookie
与原⽣应⽤程序不同，Chrome应⽤程序本⾝不能处理Cookie。
你可以使⽤扩展来克服这个。
通过，您可以检索特定域中设置的Cookie，并在发送请求时包含Cookie。
<；本地安装的Postman不存在需要安装interceptor>
1.确保在Postman中启⽤ - 检查右上⾓。
2.在测试部分，您可以使⽤“responseCookies”对象。
这将返回⼀个cookie对象数组。
要检索特定的名称，
请使⽤“ResponseCookie（cookieName）”。
这将返回⼀个cookie对象。
每个Cookie对象将包含以下属性：
domain，hostOnly，httpOnly，name，path，secure，session，storeId，value
Setting Cookies
1.确保已启⽤。
2.在Headers部分包含“Cookie”头
例如。Cookie：name = value; 2 =值2
3.发送请求。您设置的Cookie将随您的请求⼀起发送到Chrome。
7. Capturing requests (Chrome app)
抓取请求（Chrome应⽤）
Postman Interceptor
Postman Interceptor现在可以直接从Chrome捕获请求并将其保存到Postman的历史记录。
这意味着您可以实时调试您的⽹络应⽤程序API！
没有必要安装或配置代理。
还没有任何代码更改。
您可以根据正则表达式根据URL过滤请求。
如果您有⼀个⽹络应⽤程序没有已经建⽴的集合，
或者您只想调试应⽤程序正在使⽤的API，这将是⼀个巨⼤的节省时间。
在Chrome平台上构建，该功能可以在Windows，Linux，Mac和Chrome操作系统上轻松实现。
Here is what you have to do to get this working:
1. 从Chrome⽹上应⽤店安装Postman（如果您还没有）！
2. 安装Interceptor扩展
3. 打开Postman
4. 单击⼯具栏中的“”图标，然后将切换切换到“开”
5. 浏览您的应⽤程序或您的⽹站并监视请求流。

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。