Python Azure函数的API文档（Swagger UI）

Question

我们基于Azure function构建了API，所有的API都是基于Python的。我知道APIM可以很好地导入Azure function并创建和管理API。然而，我正在寻找一种轻量级且快速的解决方案，以便开发人员可以在彼此之间进行工作。

Swagger在Java生态系统中非常流行，我们在我们的Spring Boot应用程序中使用它，只需要添加一些注释即可。

是否有类似于Python编写的Azure函数的解决方案。我的最终目标是通过某些端点公开API文档，以便不同的团队（API生产者和消费者）可以在不经过协同平台等情况下高效地工作。

- SunilS

Answer 1

对于C# Azure Functions应用程序，通过官方扩展https://github.com/Azure/azure-functions-openapi-extension可以轻松实现此功能。

不幸的是，目前Python无法做到这一点。

- Mark Z.

Answer 2

在 Azure 上，这很简单。由于这些是函数，使用 Swagger 没有意义，我想也不可能。

Azure 具有内置的开放 API 定义服务。您所需做的只是创建一个 API 管理实例 并将 函数 导入其中。导入所有函数后，您可以继续下载 OpenAPI 定义 文件。您甚至可以选择将其托管在某个地方以便轻松访问。

这里是链接详细指南。

- Debdut Goswami

---

我将尝试将我的Python函数应用程序暴露给需要开放API的自定义GPT。我会带着GPT和Azure函数应用程序集成的结果回来。 - undefined

Answer 3

我不确定你是否能做到，但我工作的公司有SwaggerHub，它允许我生成多种语言的服务器存根，包括python-flask。我在其中一个API上尝试了这个功能，并检查了代码 - 它使用了一个名为Connexion的框架 - 请参见此处和此处。

Connexion是一个基于Flask的框架，可以自动处理使用OpenAPI定义的HTTP请求

另一个需要注意的事情是：根据此处的说明，看起来你可以将flask框架用于Azure函数应用。

- Ryan.Bartsch