有没有办法从 json-server 文件生成 swagger.json

Question

对于原型设计，我们使用 json-server 库，它根据我们的 db.json 文件创建伪造的 REST api。现在我们想使用招摇。

所以我的问题是，有没有办法从我们的 db.json 文件生成 swagger.json？

如果没有，你们知道一些可以轻松生成 swagger.json 文件的工具吗？

谢谢！

Answer 1

如果您可以 API 调用您的 'fake' API，您可以使用 Swagger Inspector 创建一个 API 定义 (swagger.json)！步骤：

1. 前往 https://inspector.swagger.io。您应该创建一个帐户以继续后续步骤。
2. 打电话给你的假 API。
3. Select 调用并选择创建 API 定义。
4. 按照提示命名API等
5. 您最终会进入一个包含您的 swagger.json 文件的文本编辑器（您可以复制文本或下载文件）。

瞧！

别担心，如果您不想 API 暴露在 public 中，您可以立即从 SwaggerHub 中删除 API 文件（public免费帐户的唯一选项）。