[ApiExplorerSettings(IgnoreApi = true)]在ASP.NET中的其他功能有哪些？

你已经知道这个属性能让Swagger/Swashbuckle忽略特定API的文档生成，但其实它的作用根源是控制ASP.NET Core内置的ApiExplorer组件的行为——Swagger只是ApiExplorer的一个典型使用者，所有依赖ApiExplorer获取API元数据的功能，都会受到这个属性的影响。具体来说还有这些场景：

• 自定义API文档工具：如果你的项目不用Swagger，而是自己开发了一套文档生成系统（比如内部用的Markdown文档生成器），这套系统必然会通过IApiDescriptionGroupCollectionProvider来获取所有API的描述信息。标记了这个属性的控制器或方法，会被ApiExplorer排除在外，自定义工具自然也不会把它们纳入文档。

• 动态API发现与路由管理：有些后台系统会做动态API发现功能，比如在管理界面列出所有可用的API端点，供运维人员查看、调试甚至动态配置路由规则。这时候ApiExplorer提供的元数据是核心数据源，这个属性可以把内部用的、不对外暴露的API从发现列表中隐藏。

• 客户端SDK生成：除了Swagger相关的工具，一些自定义的SDK生成器也会基于ApiExplorer的API描述来生成客户端代码（比如移动端、桌面端的API调用代码）。标记了该属性的API不会被包含在生成的SDK里，避免客户端误调用到内部接口。

• 自动化测试与巡检工具：如果有自定义的集成测试框架或系统巡检工具，需要自动枚举所有API端点来执行测试或健康检查，这个属性可以让工具跳过那些不需要对外暴露、也不需要测试的内部接口，只聚焦在公开API上。

简单来说，这个属性的核心作用是从ASP.NET Core的官方API元数据集合中移除指定的API，任何依赖这个元数据集合的功能，都会受到它的影响——Swagger只是其中最知名的一个而已。

内容的提问来源于stack exchange，提问作者SpiritBob