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