有没有办法用 Swagger 标记 API 的稳定性

Is there a way to flag stability of an API with Swagger

API 稳定性指数在 API 文档中很重要,目前我正在使用 Swashbuckle 来记录我的 API,它是用 ASP.NET Web API 构建的,我想问有没有办法用 API 稳定性指标标记 API,例如 "Stable"、"Frozen" 等

OpenAPI/Swagger 没有表示 API 稳定性的字段,但您可以使用 vendor extension 来记录它(例如 x-api-stability-index) .

参考:https://github.com/domaindrivendev/Swashbuckle/blob/953f9803bdf4a5051dd4ad90f8a6bc0ad8b6af3b/Swashbuckle.Dummy.Core/SwaggerExtensions/ApplySchemaVendorExtensions.cs#L10