如何在本地運行 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 文檔不同時，這通常是我得到的錯誤。