Python Azure 函数的 API 文档Swagger UI

我们基于 Azure 函数构建了 API，所有 API 都是基于 Python 的。我知道 APIM 提供了一种导入 Azure 函数以及创建和管理 API 的好方法。但是，我正在为开发人员寻找一种轻便快捷的解决方案，以便他们可以相互合作。

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

是否有类似的东西可用于用 Python 编写的 Azure 函数。我的最终目标是让某些端点公开 API 文档，以便不同的团队（API 生产者和消费者）可以高效地工作而无需通过汇合等

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

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

还有一点要注意；看起来您可以按照 here 为 Azure 函数应用使用 Flask 框架。

Azure 相当简单。因为，这些是函数，所以使用 swagger 没有意义，我想也不可能。

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

这是详细指南的link