如何在自研软件中使用YouTrack Event Source Bus检测工单删除？

官方推荐的稳定方案 #

Webhooks（优先选择） #

YouTrack官方提供Webhook机制，可直接监听工单删除事件，这是JetBrains官方维护的合规方案：

• 配置步骤：
  1. 以管理员身份进入YouTrack的「Settings」→「Integrations」→「Webhooks」
  2. 创建新Webhook，填写服务接收地址、名称，在「Events」列表中勾选Issue deleted事件
  3. 保存后，YouTrack会在工单删除时向你的服务发送POST请求，请求体包含被删工单的核心信息
  4. 你的AI服务只需解析请求中的工单ID，即可实时从索引中移除对应数据

REST API事件订阅 #

若Webhook无法部署，可通过YouTrack公开的REST API查询事件：

• 调用GET /api/events接口，指定fields=id,entityId,eventType参数，过滤eventType为IssueDeleted的事件
• 记录已处理的事件ID，避免重复操作，这种方式比全量工单比对效率高得多

关于/youtrack/api/eventSourceBus端点的风险 #

该端点是YouTrack内部UI使用的未公开API，不建议第三方服务依赖：

• 无官方文档支持，路径、参数、事件结构随时可能随版本更新变更，无兼容性保障
• 身份验证逻辑与UI会话绑定，第三方服务调用易出现权限失效、会话过期等问题，稳定性无法保证

实施建议 #

优先采用Webhook方案，这是最符合YouTrack生态规范的实时事件接收方式，能避免依赖内部API带来的维护风险；若受限于环境，再考虑REST API事件查询的方式。

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