如果您想快速轻松地进行 API 调用以验证您的 API 是否按预期响应,那么您来对地方了。当只需要快速检查 API 时,API 测试工具可能会效率低下。编写代码也可能不是每个人的专长,这使得使用 Swagger Inspector 测试您的 API 成为任何测试级别个人的最佳选择。
Swagger Inspector 让 API 测试变得轻而易举,它允许任何人调用端点并查看结果。这不仅对测试很有用,也适用于探索您正在考虑集成的新 API,或者只是好奇您可以从中获取哪些信息。它是免费使用的,并且不一定需要登录!
在本教程中,我们将介绍如何使用 Swagger Inspector 进行基本的 API 调用
在此示例中,我们将使用星球大战 API。主要是因为我最近看了《原力觉醒》(对此我有很多想法,不幸的是,这篇博客并非关于《原力觉醒》的评论文章,如果您对此也有看法,请在推特上告诉我们……),但也是因为它的内容很容易被各种人理解。
您可以随意跟随本教程,并用您选择的端点替换示例。
步骤1 – 登录
打开 Inspector 并登录或注册。如果您已有SwaggerHub账户,可以使用该凭据登录。注册后您可以保存您的调用历史记录,并在准备就绪时生成一个OpenAPI定义。

步骤2 - 下载 Chrome 扩展程序
如果这是您第一次使用 Swagger Inspector,并且您正在尝试检查防火墙后的 API,您需要下载 Swagger Inspector Chrome 扩展程序。您无需
离开本站即可完成。如果您使用 Safari 浏览器,请在 Safari 的开发者选项中“禁用跨域限制”。这将是访问许多 API 所必需的。
星球大战 API 不需要下载扩展程序,但如果您想测试其他 API,那么该扩展程序将对您的测试成功至关重要。


步骤3 – 发送调用
将您的端点粘贴到页面顶部的输入框中 – 点击发送。
在此示例中,我正在调用 https://swapi.co/api/people/13 资源下的 GET 方法。以下是关于此资源将返回哪些信息的提示...


太棒了!看起来所有正确的信息都已提供。
瞧,您已经正式完成了一次基本的 API 测试。 使用 Swagger Inspector 就是这么简单。无需设置时间,无需桌面下载,无需等待。
尝试使用您自己的 API 端点,或者继续使用星球大战 API 来了解 Swagger Inspector 的工作原理。 继续尝试其他几个端点以积累各种请求,然后尝试创建一两个集合,并生成一个 OpenAPI 定义!
要了解更多关于 Swagger Inspector 如何帮助您实现 API 成功的信息,请访问Swagger Inspector 页面,并立即开始测试您的 API!
我们还为您制作了一个视频演示,如果这种方式更适合您,可以跟着学习。视频下方您可以找到文字稿。
文字稿:
大家好,我叫 Shannon,今天来和大家简单介绍一下 Swagger Inspector。
它是 Swagger 家族中的最新工具,我们对此产品感到非常兴奋!
特别是,它创建 API 定义的能力非常棒,我们知道会吸引人们不断回访的原因是它能够反复进行 API 调用并对其进行分类。
您可以做所有您在与 API 交互时想做的事情,而且您需要一个 UI 来完成这些。
使用这个工具,您可以测试您的 API 端点。我目前最喜欢的 API 是星球大战 API。它非常棒,您可以获取与星球大战宇宙相关的行星。
调用星球大战 API,可以看到塔图因是行星中的第一名。
您可以使用 Swagger Inspector 快速轻松地进行 API 调用,并且您还可以固定您的 API 调用。
您可以选择一个 API 调用,然后说“好的,这是我最喜欢的,我要继续进行这个 API 调用”。
如果您改变主意,只需取消固定请求,然后您可以将这些请求添加到集合中以对调用进行分类。
您还可以做的另一件事是创建 API 定义,因此可以在您的 API 调用历史记录中勾选,或者直接进入一个集合并选择集合中的所有调用。
选择集合中的特定调用并创建您的 API 定义。
一旦您这样做,我们将自动生成此定义,因此如果您有多个 API 调用,您可以选择所有这些调用。
我们正在后台进行一些重构,确保我们理解与您的 API 相关的路径,以及您在使用 Swagger Inspector 时使用的所有查询参数。
最后,当您创建 API 时,我们会要求您提供一个名称,然后根据这些 API 调用,使用我们掌握的所有相关信息创建您的 API 定义。
一旦您进入 SwaggerHub,您就可以在那里扩展您的 API。
添加任何具体内容,例如在此处添加标题。这将存储 API 和所有这些更改。
在 SwaggerHub 中,您可以保存 API 并对其进行其他很酷的操作。
关于 Swagger Inspector,今天我能说的就这些了。
Swagger Inspector 是免费的,我们计划一直保持免费!