如何在本地运行 REST API 服务器和 Swagger？

Question

我使用 flask-restplus 对我所有的 api 代码库进行了编码，我想将其与 swagger 服务器代码工件进行整合。 作为参考，我在 github 上使用了这个openapi 规范文件，并使用在线swagger 编辑器生成了 swagger 服务器，这基本上很好地创建了服务器代码工件。 我想在 flask-restplus 中整合我的代码以一起生成 swagger 服务器代码。 当我尝试从本地 python 终端运行它时，出现以下错误：

{
  "detail": "The requested URL was not found on the server. If you entered the URL manually please check your spelling and try again.",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

有趣的是我可以在本地运行我自己的 flask-restplus api，我可以打开服务器端点。 但我无法运行 swagger 服务器，它是根据 swagger 编辑器的 openapi 规范文件生成的。 为什么？ 在本地运行 swagger 服务器的解决方案是什么？ 我确实尝试过使用不同的主机和帖子，但仍然无法打开 swagger 服务器。 对此有什么想法吗？ 谢谢

更新：

关键是我想在本地运行 swagger 服务器工件，然后我可以将我在 flask-restplus 中的代码库整合到这个服务器上，这样我就可以有更好的形状。 有什么想法让这个工作吗？ 谢谢

我的问题是在我将 api 规范文件提供给 swagger 编辑器并下载服务器代码库之后，我如何从 python 控制台/cmd 在本地运行它？ 为什么我不能通过点击python __main__.py来运行？ 我应该怎么办？ 任何人都可以帮助我吗？ 谢谢

Answer 1

您是否尝试按照此博客中的教程进行操作？

https://towardsdatascience.com/working-with-apis-using-flask-flask-restplus-and-swagger-ui-7cf447deda7f

您需要确保 swagger 中的 operationID 与代码中的路由匹配。 我没有使用 flask rest plus 但我使用的是 flask 和连接，当路由名称与 swagger 文档不同时，这通常是我得到的错误。