Postman Echo

一、前言

  Postman Echo为用户提供API调用的示例服务，其中包括GET、POST、PUT等请求及各种Auth机制的请求调用。下面将借助Postman Echo来学习如何构建请求。

二、请求方法

  HTTP请求方法，如GET、PUT、POST、DELETE、PATCH、HEAD等。不同的请求方法定义了请求将如何被服务器解释。Postman支持所有的HTTP请求方法，包括一些很少使用的方法，如PROPFIND、UNLINK等。接下来将讲述HTTP常见请求方法的构建步骤。

  1.GET请求

  HTTPS GET请求方法是从服务器检索数据。数据由统一资源标识符（URI）标示。GET请求将参数拼接在URL后面并传递给服务器（参数的Key与Value之间有“=”号，Value不需要引号包裹，多个参数之间用“&”符号连接）例如https://postman-echo.com/get?fool=bar1&foo2=bar2中，第一个参数“foo1=bar1”，第二参数“foo2=bar2”。

  用Postman构建请求及收到的响应，如图所示：

  2.POST请求

  HTTP POST请求方法是指将数据传输到服务器并引发响应。返回的数据取决于服务器的实现。用户可以将参数拼接在统一资源定位符（URL）后面传递给服务器。例如URL为https://postman-echo.com/post，参数为date=hello postman。

  （1）用Postman构建请求及收到的响应如图：

  （2）以form-data形式传递参数，用Postman构建请求及收到的响应如图：

  （3）以x-www-form-urlencodeed形式传递参数，用Postman构建请求及收到的响应，如图：

  （4）以raw形式传递参数，用Postman构建请求及收到的响应，如图：
  （5）以binary形式传递参数，用Postman构建请求及收到的响应，如图：

  3.PUT请求

  HTTP PUT请求方法类似于HTTP POST。同样是将数据传输到服务器（并引发响应）返回的数据取决于服务器的实现。用Postman构建请求及收到的响应，如图：

  4.PATCH请求

  HTTP PATCH方法用于在服务器上更新资源。一般来说，PATCH请求支持URI拼接传递参数，也支持在请求体中以form-data形式传递参数，用Postman构建请求及收到的响应，如图：

（1）PATCH请求方式一：

（2）PATCH请求方式二：

  5.DELETE请求

  HTTP DELETE方法用于在服务器上删除资源。一般来说，DELETE请求支持URL拼接传递参数，也支持在请求中以form-data的形式传递参数，用Postman构建请求及收到的请求，如图：

三、Headers

  请求头（Request Headers）是请求报文特有的，它为服务器提供了一些额外的信息，例如，客户端希望接收什么类型的数据。

  响应头：（Response Headers）则便于客户端提供信息，例如，客服端在与哪种类型的服务器进行交互。

  1.GET Request Headers

  用Postman构建请求头，如图：

  2.GET Response Headers

  借助Postman查看响应信息，如图所示，该响应包含7个响应头

四、认证方法

  1.基本认证

  使用Postman来构建基本认证（Basic Auth）权限认证请求，当传递正确的用户名和明码时，将返回一个“200 OK”的状态码，如图：

  如果不传递密码，或密码传递错误，将返回“401 Unauthorized”，如图：

  2.摘要身份验证

  使用Postman来构建摘要身份验证（Digest Auth）权限
认证请求，使用方法如图：

  3.Hawk Auth

  Hawk 是一种新型的HTTP身份验证方案，下面使用Postman工具构建Hawk Auth权限认证请求，如图：

  4.OAuth

  正如前文所述，OAuth是一个开发标准，它不需要将用户名和密码提供给第三方应用，就允许用户让第三方应用访问该用户在某一网站上存储的秘密资源。

  使用Postman工具构建OAuth 1.0权限认证请求，如图：

五、Cookies操作

  1.设置Cookies

  在接口请求“https://postman-echo.com/cookies/set?fool=bar1&foo2=bar2”中，有两对“Key-Value”的参数作为GET请求的一部分。这些参数被当成Cookies保存起来，可以检索或删除。该请求的响应返回一个JSON，其中列出了所有的Cookies，如图所示：

  2.获取Cookies

  使用“https://postman-echo.com/cookies”接口获取储存在该域上所有Cookies列表，如图

  3.删除Cookies

  接口请求“https://postman-echo.com/cookies/delete?foo1”用来删除域中指定的Cookies，返回值为域剩余Cookies（JSON格式），如图：