Swagger 多重定义最佳实践

我有一个 API 和一个消费者 Web 应用程序，都是用 Node 和 Express 编写的。API 由 OpenAPI 规范定义。由swagger-ui-express实现。

上述 Web 应用程序已进行 Docker 化并在 Kubernetes 中进行管理。

该 API 有一些端点用于管理用户注册/应用服务的生命周期。

目前，当我需要清除已完成/放弃的应用程序或重新提交失败的应用程序时，我会使用定期运行的 cronjob 来对上述操作执行数据库查询。cronjob 由 Kubernetes 配置 YAML 文件定义。这很快就会变得难以管理且难以维护。

我正在寻求为上述每项任务建立一个专用端点。然后，专用的 cronjob 可以定期向 API 端点发送请求来执行复杂的任务。这会将业务逻辑移回 API，并避免在其他地方托管的 cronjob 中出现重复。我最终要问这是否是一个好方法，或者是否有更好的工作流程记录在我可以实施的地方？

我的想法是，我可以将这些新端点添加到现有的消费者 API 中，但将新的（内务/管理）端点与其他端点分开。

为了将每个（当前）端点分离到各自的资源中，我在规范中定义了标签。标签似乎不足以分离这些新的“内务”端点。

浏览SwaggerUI 文档，我可以看到我可以定义多个定义（通过urls属性）来进行切换。这些定义由单独的规范文档提供支持。这看起来像是一种将消费者 API 与管理 API 分离的非常干净的方法，这是最佳实践吗？

任何意见都将不胜感激，因为我正在努力寻找有关此类问题的大量文档。