openapi - OpenApi 3.0 排除内部 api 定义

Question

我们需要使用 Php 注释生成 API 的多个定义。

在生成 api spec(json/yml) 时，需要排除我们不应该暴露给外界的内部 api。

我正在使用 swagger 来生成 api 文档。

OpenApi 3.0 和 swagger 有什么可能吗？我们可以将 api 命名为内部和外部并根据此标签排除吗？

Answer 1

Swagger-php 不提供过滤，解决方案是使用像openapi-filter这样的外部工具从生成的规范中删除内部 api。