停用旧的 REST API,需要采取措施

Read this post in other languages:

这篇博文旨在提醒与构建 YouTrack 外部集成相关的重要技术变更,以及 YouTrack 管理员和负责为团队设置外部集成的人员在 2021 年 6 月底前必须采取的措施。

有什么变化?

两年前,我们宣布开始逐步发布新的 REST API 资源和方法。 我们竭尽全力使新 API 安全且灵活,让用户能够高效地构建自定义集成,同时解决旧 API 的痛点。

新 REST API 现已成为一项完全受支持并具备发布级质量的功能,现在是时候停用旧方法了,因为我们希望将精力放在维护和增强新 API 上。

我们计划在 2021 年 7 月开始过渡,并希望在年底之前完成。 当然,我们会确保先将所有官方库、插件和微件迁移至新 API,然后再停用旧版本。

什么是旧 REST API 方法?

YouTrack REST API 方法大多用于在 YouTrack 与第三方工具之间构建自定义集成,扩展原生 YouTrack 功能。 例如,集成的工具能够从 YouTrack 获取问题,然后基于数据构建自定义图表。

如果您的团队构建了任何自定义集成,请花点时间检查一下。 旧方法使用 /rest URL 前缀,而新方法则使用 /api

用户需要采取的措施

过渡完成后,将无法在 2021 年 7 月及以后发布的 YouTrack 版本上使用旧 REST API。 所有依赖旧 REST API 方法的自定义集成也将停止运行。 请确保在 2021 年 7 月之前将您的所有自定义代码迁移至新 REST API,以免您的日常工作出现中断。 2021 年 7 月 1 日后,我们将无法保证旧 REST API 方法可以运行。
新 REST API 的文档详细介绍了新端点,我们也将提供一组可以立即使用的示例来帮助您熟悉新 API。

YouTrack 与外部工具的集成呢?

我们深知有几项 YouTrack 集成被用户广泛使用,但他们却无计可施,例如与管理系统的集成。 我们计划联系这些应用程序的代表来沟通后续变更事宜,并提供力所能及的帮助以确保将这些集成迁移到新 REST API。

如果您有任何问题,或者需要协助来将您的集成迁移到新 REST API,请联系我们的支持团队。 我们将随时为您提供帮助!

您的 YouTrack 团队

Discover more

YouTrack 2023 路线图

新年开始之际,我们想在这里分享更新的路线图并重点介绍 YouTrack 未来的长期目标。 感谢我们的忠实用户,YouTrack 客户群在全球范围内迅速增长,我们将继续致力于为各行各业的团队打造更强大的工具。 我们的产品承诺和抱负 去年,我们分享了我们的 2022 路线图和长期计划,我们高兴地报告我们的愿景得到了很好地实现,因此,我们的产品承诺在稳步推进。 YouTrack 正在成为软件开发与 IT 部门、产品与项目管理、营销、财务、行政和许多其他领域团队的通用工具,它允许您以自己的方式工作、协作和交流。 我们的长期计划是继续开发 YouTrack 以处理更广泛的用例,从针对中小型公司的简单任务管理到面向大型企业的复杂项目协调。 我们致力于让您自由选择应用程序和数据的托管位置。 我们为此继续协同开发 YouTrack Cloud 和 YouTrack Server,让团队可以根据需要在云和本地部署托管之间轻松迁移。 我们在 2023 年的工作计划 帮助台 首先,我们将为提供外部客户支持或管理内部请求的团队引入专属帮助台解决方案。 新的帮助台项目将简化支持代表的工作,并使其与同事(组织中的贡献者)之间的协作变得轻而易举。 您将能够在帮助台中管理支持流,使用单独的按代表计费的灵活许可模式,订阅中包含额外的免费报告者容量。 帮助台将提供用于管理自定义支持服务等级协议的工作流,以及一个简化