Postman使用手册范本Word下载.docx

1、右击选中的文本,然后单击EncodeURIComponent手工编码参数值。You can individually add key/value pairs and Postman will combine everything together. If your URL already has parameters - for example, if you are pasting a URL from some other source, Postman will split the URL into pairs automatically.您可以单独添加键/值对,postman会结合在一

2、起的一切。如果你的URL已经参数例如,如果你是粘贴URL从其他来源,postman将URL分成自动配对HeadersClicking on the headers toggle will show the headers key-value editor. You can set any string as the header name. Common headers part of the HTTP spec are available in an auto-complete drop down when you begin typing the header name. Values f

3、or the Content-Type header are also available in an auto-complete drop down. 单击标题切换键值编辑器将显示头。你可以设置任何字符串作为标题名称。常见的HTTP标头部分规范在一个自动完成拉当你开始键入标题名称。“内容类型”头的值也可以自动完成下拉。Header presetsYou can save commonly used headers together in a header preset. You can add a header preset to your request by clicking the A

4、dd preset button or by selecting the preset from the header dropdown. 您可以保存常用的标题在标题预设。您可以添加一个头预定你的请求通过单击“添加预设”按钮或通过选择预设的标题下拉MethodChanging 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

5、a body attached to it or not. 改变方法很简单。只是选择方法从请求主体的选择控制。编辑器区域将会改变取决于方法可以有身体连接到它。The ability to add additional methods and toggling whether a body can be attached to it will be added soon 添加额外的方法和切换的能力是否身体可以被附加到它很快就会被添加Request bodyWhile constructing requests, you would be dealing with the request body

6、 editor a lot. Postman lets you send almost any kind of HTTP request （If you cant send something, let us know!）. The body editor is divided into 4 areas and has different controls depending on the body type. 而构建请求,您将处理请求主体编辑器。postman让你送几乎任何类型的HTTP请求（如果你不能送东西,让我们知道!）。身体编辑分为4个区域,根据身体类型有不同的控制。form-data

7、multipart/form-data is the default encoding a web form uses to transfer data. This simulates filling a form on a website, and submitting it. The form-data editor lets you set key/value pairs （using the key-value editor） for your data. You can attach files to a key as well. Do note that due to restri

8、ctions of the HTML5 spec, files are not stored in history or collections. You would have to select the file again at the time of sending a request. 多部分/格式数据是默认编码一个web表单使用传输数据。这对一个网站模拟填充表单,并提交它。格式数据编辑器允许您设置键/值对（使用键值编辑器）为您的数据,您可以将文件附加到一个关键。做注意,由于HTML5规范的限制,文件不存储在历史或集合。你会选择文件再次发送请求的时候。urlencodedThis en

9、coding is the same as the one used in URL parameters. You just need to enter key/value pairs and Postman will encode the keys and values properly. Note that you can not upload files through this encoding mode. There might be some confusion between form-data and urlencoded so make sure to check with

10、your API first. 这个编码是一样使用的URL参数。你只需要输入键/值对,postman将编码键和值正常。请注意,您不能上传文件通过这个编码模式。可能会有一些混淆格式数据和urlencoded所以一定先检查你的API。rawA raw request can contain anything. Postman doesnt touch the string entered in the raw editor except replacing environment variables. Whatever you put in the text area gets sent with

11、 the request. The raw editor lets you set the formatting type along with the correct header that you should send with the raw body. You can set the Content-Type header manually as well. Normally, you would be sending XML or JSON data here. 原始请求可以包含任何东西。postman不碰在原始编辑器中输入的字符串取代环境变量除外。无论你的文本区域发送请求。原始编

12、辑器允许您设置格式类型以及正确的标题,你应该发送原始的身体。你也可以手动设置content - type头。通常,你会在这里发送XML或JSON数据。binarybinary data allows you to send things which you can not enter in Postman. For example, image, audio or video files. You can send text files as well. As mentioned earlier in the form-data section, you would have to reatt

13、ach a file if you are loading a request through the history or the collection. 二进制数据允许你发送的东西你不能进入postman。例如,图像,音频或视频文件。您可以发送文本文件格式数据节。正如前面提到的,你必须将一个文件加载请求通过历史或集合。Working with responsesEnsuring that the API response is correct is something that you will be doing a lot. The Postman response viewer wil

14、l make this task much easier for you.确保API的反应是正确的,你会做很多。postman响应查看器将使这项任务变得更简单。An API response consists of the body, headers and the status code. Postman organizes body and headers in different tabs. The status code with the time taken for the API call is displayed next to the tabs. You can hover o

15、ver 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. API的反应包括身体、头和状态码。postman组织体在不同的标签和标题。时间的状态代码旁边的API调用显示选项卡。你可以悬停在状态代码更详细的代码。主要是它将默认API描述HTTP规范强制要求的,但作者也可以添加自定义消息。Saving respons

16、esIf 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. Youll 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 re

17、quest URL）. 如果请求被保存在一个集合,您可以保存响应请求。只有在接收到响应后,单击“保存响应”按钮。你可以保存响应与一个名字。所有响应保存请求可以无论何时加载请求（在请求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.postman身体标签给你一些工具来帮助您理解

18、事情很快。身体可以在三种观点漂亮,生和预览PrettyThe 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 i

19、n 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.

20、You can enable the Force JSON setting as well.漂亮模式格式JSON或XML响应,这样他们更容易看。没人想滚动一个缩小的单线JSON响应寻找难以捉摸的字符串!突出漂亮的模式中的链接,点击可以加载一个GET请求的postman链接URL。通过点击左边的行号你可以折叠大量响应。postman自动格式,确保适当的内容类型返回头。如果API不这样做,那么你可以迫使通过JSON或XML格式。您可以启用“JSON力量”设置。Note: You can use Cmd+F / Ctrl+F to open the search bar, and Cmd+G / C

21、trl+G to scroll through results. 注意:您可以使用Cmd + F / Ctrl + F打开搜索栏,和Cmd + G / Ctrl + G滚动结果。RawThe raw view is just a big text area with the response body. It can help to tell whether your response is minified or not.原始的观点只是一个大文本区域响应的身体。它可以帮助你判断反应是否缩小。PreviewThe preview tab renders the response in a sa

22、ndboxed 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.preview选项卡呈现响应在沙箱iframe。一些web框架默认返回HTML错误和preview模式尤其有帮助。由于iframe沙箱限制,Javascript和iframe图像被禁用。You ca

23、n 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.你可以最大化的身体占据整个postman窗口。在情况下,你计划花费了大量的时间和响应,这是路要走。If your API endpoint returns an image, Postman will detect and render it automatically. For binary response ty

24、pes, 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.如果你的API端点返回一个形象,postman将自动检测并呈现它。对于二进制响应类型,你应

25、该选择“发送和下载”,会让你节省硬盘的响应。然后你可以查看它使用适当的观众。这使您的灵活性来测试音频文件,pdf,zip文件或任何API抛给你。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

26、by default.标题显示的键/值对标题标签。徘徊在标题的名称可以给你描述标题根据HTTP规范。如果你发送HEAD请求,postman将显示默认标题标签。Basic AuthEnter the username and password fields and hit Refresh headers to generate the authorization header.输入用户名和密码字段,并点击“刷新头”生成授权头。Digest AuthDigest auth is more complicated than basic auth and uses the values current

27、ly 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 its already present.消化身份验证是更复杂的比基本认证和使用请求中的值目前设置生成授权头。确保他们正确设置之前生成标题。postman会删除现有的头如果它已经存在。OAuth 1.0aPostmans OAuth helper lets you s

28、ign requests which support OAuth 1.0a based authentication. Currently it does not let you acquire the access token. Thats something you would need from the API provider. The OAuth 1.0 helper can set values in either the header or as query parameters.Postman的OAuth助手让你签署请求支持OAuth 1.0基础认证。目前它不让你获取访问令牌。

29、这是需要从API提供者。OAuth 1.0助手可以在标题或设置值作为查询参数。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请求可能认为不同nonce价值,postman可以刷新OAuth签名发送请求之前如果启用了自动添加参数。The OAuth 1.0 spec is quite complicated