Python Azure函数的API文档(Swagger UI)



我们已经基于Azure函数构建了api,所有api都是基于python的。我知道APIM提供了一种导入Azure功能、创建和管理api的好方法。然而,我在寻找一盏灯。为开发人员提供快速解决方案,使他们能够在自己之间工作。

Swagger在Java生态系统中非常流行,我们在spring引导应用程序中只添加了一些注释。

用Python编写的Azure函数是否有类似的可用功能?我的最终目标是让一些端点公开API文档,以便不同的团队(API生产者&消费者)可以有效地工作,而不需要经过汇流,等等

这当然可以很容易地通过这个官方扩展https://github.com/Azure/azure-functions-openapi-extension c# Azure函数应用程序

不幸的是,我不认为Python在这个时候也可以这么说。

使用Azure非常简单。因为,这些都是函数,使用swagger没有意义,我想这也不可能。

Azure有一个内置的开放API定义服务。你所需要做的就是创建一个API Management Instance,然后将functions导入其中。导入所有功能后,可以下载OpenAPI definition文件。您甚至可以选择将其托管在易于访问的地方。

这里是详细指南的链接

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

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

另一件要注意的事情;看起来你可以使用flask框架的Azure功能应用程序,按这里。

最新更新