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。