Postman 测试 API 调用 OpenWeatherMap 查询各个城市天气

本篇文章翻译自: https://www.learnhowtoprogram.com/lessons/testing-api-calls-with-postman

我们来讨论一个名为 Postman 的便利工具,它提供了一个用于制作和测试 API 调用的友好用户界面。 Postman 目前并未安装在所有电脑上。 如果您没有看到它,请访问邮递员网站并下载 MacOS 或 Chrome 应用程序。 Chrome 应用程序将很快启动。 您可以选择注册一个帐户,或者使用Postman 而不用帐号。 您也可以将其安装在家庭环境中。

注意:Postman 不会有 CORS 问题,因为 Postman 中的API 调用不是源于浏览器。 如果您使用 JavaScript 从浏览器进行 API 调用,则应始终确认 API 实现 CORS 。

让我们来看看在 Postman 中进行 API 调用的基础知识。 例如,我们将在 Open Weather API 中查询 SuZhou 的天气情况。

API Keys

首先,我们需要从 Open Weather API (https://openweathermap.org/api) 获得一个 API Key。 这是一个特殊的代码,允许我们请求数据,并将我们在应用程序中的任何请求与我们拥有的帐户相关联。 除此之外,这有助于 API 拥有者确保人员和应用程序不会因为不必要的大量请求而陷入困境。

您可以通过在注册页面上创建一个基本帐户来快速获得免费的 Open Weather API 密钥。 成功创建帐户后,您可以在用户信息板的 API 密钥分区中锁定您的 API 密钥。 保持这个关键的方便,我们会在短时间内使用它!

Using Postman

现在我们有一个 API Keys,我们来用它来测试 Postman 中的一个 API 调用。 现在打开程序,你应该看到这样的东西:

  1. 我们选择我们想要的那种请求。 在这种情况下,这是一个 GET 请求,因为我们要求从 Open Weather API 接收数据。
  2. 我们可以输入没有查询字符串的 API URL。 对于此调用,URL为http://api.openweathermap.org/data/2.5/weather。 然后,您可以单击 Params按钮添加参数作为键值对。 这里我们添加了 q 和 appid 以及相应的值。 (在上面的示例中,appid 已被删除;但请确保将您刚才收到的唯一 API 密钥放在这里!)您也可以直接在 URL 中输入参数,单独添加参数可以更容易保持组织(避免打字错误)。
  3. 单击 Headers 选项卡添加任何标题。 我们在这里添加了一个 “Accept:application / json”标头。 在标题右侧,有一个“body”选项卡。 它是灰色的,因为这是一个 GET 请求,但是如果您正在进行 POST 或 PUT 请求,则可以指定请求正文。 还要注意标题左边的授权标签。 您可以在此添加 OAuth 等授权。
  4. 这是您将在其中找到伴随响应的 HTTP 状态代码。 该调用返回 200 OK 状态。
  5. JSON 格式可以以 “pretty” 的形式返回。 这使得读取 JSON 响应非常容易,看看它是如何嵌套的!
  6. 您可以使用选项卡一次使用多个API调用。
  7. 发送按钮是不言自明的。 配置完呼叫后,单击发送以发出请求。
  8. 您甚至可以保存API调用以供将来使用。 这在多天项目工作时特别有用。