使用Azure Functions自动生成OpenAPI文档

Question

3

能否在Azure Functions中自动生成OpenAPI文档，就像使用Swashbuckle和ASP .NET Core时可以生成SwaggerGen一样？文档应包含不同的端点及其可能的输入和响应模型以及状态码。如果我能在Web UI中查看文档，那就太棒了。

目前，我发现了两个可能的包：

1. 用于Azure Functions的Swashbuckle适配器：https://github.com/vitalybibikov/AzureExtensions.Swashbuckle 2. 来自Microsoft的官方OpenAPI扩展：https://github.com/Azure/azure-functions-openapi-extension 对于第一个包，只能检测我的模型/DTO和不同的端点。但端点与模型之间的关系以及可能的响应码必须通过在几个函数上设置属性来手动设置。

对于第二个包，根本没有自动检测。一切都只能通过属性工作。此外，该软件包仍处于预览状态。

- Stimmler

可能的响应代码必须通过在几个函数上设置属性来手动设置。这对于服务也是如此，不是吗？ - Code Name Jack

1个回答

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- RKM · Accepted Answer

根据微软官方文档，目前已不处于预览状态，您可以使用进程内模型和进程外模型来启用Azure Functions上的OpenAPI端点。

通过使用文档中提到的扩展，我们可以生成OpenAPI文档。