宣布日期 开始推行 结束推行
2026 年 6 月 1 日 2026 年 7 月 28 日 2027 年 4 月 30 日

Zendesk 拟将移除 API 令牌这一身份验证方法。从 2026 年 7 月 28 日起，未使用的令牌将自动取消激活。到 2027 年 4 月 30 日，所有 API 令牌都将停止运行。您必须在最终截止日期之前将整合迁移到 OAuth。此更改仅影响当前使用 API 令牌的 API，包括工单处理、帮助中心和语音等 API。不适用于其他 Zendesk 产品。

此公告包括以下主题：

  • 有什么变化？
  • Zendesk 为何作出这项更改？
  • 我需要做些什么？
  • 常见问题解答

 

有什么变化？

Zendesk 将分三个阶段移除 Support API 令牌。推行包括自动取消激活未用的令牌，阻止创建新令牌，以及强制取消激活的最终日期。

第 1 阶段（2026 年 7 月 28 日开始）：自动取消激活 

2026 年 7 月 28 日，以下更新将当天生效：

  • 一次性清理：任何超过 30 天未使用的令牌都将被取消激活。已取消激活的令牌无法用于发出 API 请求。取消激活达 60 天以上的 API 令牌将被永久删除。 
  • 开始自动取消激活：从 7 月 28 日起，任何超过 30 天未使用的令牌都将自动取消激活。如果 API 令牌处于取消激活状态超过 60 天，则将被永久删除。 
  • 阻止新建帐户：在 2026 年 7 月 28 日及之后创建的帐户无法创建或使用 API 令牌。 

您可以在 60 天的宽限期内重新激活已取消激活的 API 令牌，避免它们被永久删除。 

第 2 阶段（2026 年 10 月 27 日开始）：阻止创建新令牌 

帐户无法再通过用户界面或 API 创建新的 API 令牌。除非取消激活，否则现有的活跃令牌在 2027 年 4 月 30 日之前一直有效。

第 3 阶段（2027 年 4 月 30 日生效）：强制取消激活 

所有剩余的 API 令牌将被永久取消激活。管理员无法重新激活令牌，API 令牌管理页面将从管理中心移除。

 

Zendesk 为何作出这项更改？

永久、整体生效的 API 令牌被 OAuth 取而代之，为您的 API 驱动型工作流提供更安全、更短效且权限范围更精准的访问。OAuth 是安全 API 访问的行业标准，安全功能无法通过改装融入 API 令牌架构。API 令牌最初的宗旨是实现访问便捷性而非安全性，且缺乏防止凭证泄露的基本防护。

API 令牌的安全限制

API 令牌缺乏基本的安全控制：

  • 无轮换机制：没有主动轮换凭证的安全措施。轮换 API 令牌需要撤销旧的令牌，手动更新所有整合，这就导致您不得不在安全性和正常运行时间之间取舍。
  • 缺乏粒度权限：API 令牌可用于模拟您帐户中的任何用户，包括管理员。您无法将令牌的范围限定为特定操作，也无法限制其扮演的用户身份，令牌提供的是“全有或全无”的帐户访问权限。
  • 无到期设定：令牌在使用期间一直有效。虽然我们为未使用的令牌引入了自动取消激活，但一直处于使用活跃状态的凭证永不过期，因此攻击者只要每隔几天使用一次被盗令牌，就可以维持永久访问权限。

如果令牌因代码存储库暴露、凭证泄露或系统被入侵而遭到破解，攻击者将获得持久的帐户访问权限。这些被盗用的令牌通常在数月之后才会被发现，在此期间一直有效。

为何改用 OAuth 而非改进 API 令牌机制

现代身份验证要求具备自动过期、凭证轮换和细粒度权限范围等安全功能，而这些能力从根本上依赖于一套完全不同的身份验证架构。在 API 令牌中加入这些保护，本质上就是让它们像 OAuth 一样运行——只是换了名字而已。更重要的是，API 令牌的任何改进均需您更新 API 驱动的工作流程。OAuth 才是更值得投入的选择：作为行业标准的身份验证协议，它持续演进、主动应对新威胁，并提供了坚实可靠的基础架构。

 

我需要做些什么？

立即查看您的 API 令牌

  1. 在管理中心，单击应用和整合 > API > API 令牌。
  2. 检查每个令牌的“最近使用”日期。
  3. 满 30 天未使用的令牌将于 2026 年 7 月 28 日被取消激活。
  4. 查看令牌描述，确定哪些工作流程使用这些令牌。

 

了解中断的流程

如果您不及时迁移，任何使用 API 令牌的整合都将停止运行。影响取决于您对使用 API 令牌（而非 OAuth）的 API 驱动工作流程的依赖程度：

  • 更新工单或修改 Zendesk 帐户中数据的 Webhook
  • 用于自行程序或数据同步的自定义脚本
  • 由承包商或外部开发者构建的第三方整合
  • 专员从不直接与 Zendesk 用户界面交互的中间件工作流程

使用已取消激活的 API 令牌进行 API 调用将返回身份验证错误。工作流程将停止执行，工单不会同步，且自动流程可能会失败并静默处理。

迁移到 OAuth

OAuth 是取代 API 令牌的现代身份验证方法。您需要：

  1. 在管理中心创建 OAuth 客户端。
  2. 使用 client_credentials 或 authentication_code grant 来获取访问令牌。
  3. 更新您的整合以使用 OAuth，而非 API 令牌。

有关更多信息，请参阅我们开发者文档中从 API 令牌迁移到 OAuth 访问令牌。 

监测您的 API 令牌

从 7 月 28 日起，系统将推出新工具来帮助您管理此过渡：

  • API 令牌页面中的“取消激活日期”列显示未使用的令牌将于何时自动取消激活。
  • API 令牌页面中的使用量报告，显示最近 7 天使用 API 令牌发出的 API 请求（每天生成，以建立滚动历史记录）。
  • 电邮通知将提醒所有管理员：
    • 7 月 28 日清理前 5 天（7 月 23 日和 7 月 27 日）
    • 令牌满 30 天未使用阈值（取消激活警告）之前的第 25 天和第 29 天
    • 已取消激活的令牌被永久删除之前的第 55 天

使用宽限期

2026 年 7 月 28 日至 2027 年 4 月 30 日，您可以：

  • 测试 OAuth 实施
  • 识别哪些 API 令牌用于哪些工作流程
  • 重新激活已取消激活的令牌（永久删除前 60 天内）
  • 增量迁移，无需一次迁移所有内容

 

常见问题解答

关键日期的事件

日期 事件
2026 年 7 月 23 日 首封电邮通知：列出将于 7 月 28 日取消激活/删除的令牌
2026 年 7 月 27 日 提醒电邮（推行前 1 天）
2026 年 7 月 28 日

开始推行：

• 一次性清理：令牌超过 30 天未使用 → 已取消激活；令牌已取消激活 60+ 天 → 已删除

• 开始自动取消激活： 

  • 任何超过 30 天未使用的令牌 → 启动自动取消激活流程
  • 任何取消激活 60 天的令牌 → 以后将自动删除

• 阻止新帐户：在此日期或之后创建的帐户无法创建 API 令牌

• 用户界面更新：“取消激活日期”列和使用量报告
进行中（7 月 28 日以后）

电邮通知在令牌满 30 天未使用阈值（取消激活警告）之前的第 25 天和第 29 天发送

电邮通知在令牌达到 60 天取消激活阈值（删除警告）前的第 55 天发送
2026 年 9 月 21 日 发送首封删除警告电邮（对于 7 月 28 日取消激活的令牌）
2026 年 9 月 26 日 首批令牌已自动删除（7 月 28 日取消激活且从未重新激活的令牌）
2026 年 10 月 27 日 任何人都无法再创建新的 API 令牌（现有令牌仍然有效）
2027 年 4 月 30 日 最终截止日期：所有 API 令牌永久停止工作，无法重新激活

是否可以阻止令牌在 7 月 28 日被取消激活？

可以，只要您在 6 月 28 日至 7 月 28 日之间使用令牌。2026 年 7 月 28 日将检查所有令牌的活跃状况。“最后使用”日期在 30 多天以前的令牌将被取消激活。

如何重新激活已取消激活的令牌？

  1. 在管理中心，单击应用和整合 > API > API 令牌。
  2. 找到已取消激活的令牌（状态显示“已取消激活”）。
  3. 单击令牌旁边的选项菜单图标，然后选择“重新激活”。
  4. 令牌可立即再次使用。

任何已取消激活的令牌可以在取消激活后 60 天内重新激活。60 天后，令牌将被永久删除，无法恢复。2027 年 4 月 30 日之后，无法重新激活任何令牌。


 

如何得知哪些令牌钥将被取消激活？

从 7 月 28 日起，您的 API 令牌页面将显示“取消激活日期”列。您还将收到发送给所有管理员的电邮通知：

  • 取消激活前 5 天（例如 7 月 28 日清理，则为 7 月 23 日）
  • 取消激活的前 1 天（例如 7 月 28 日清理，则为 7 月 27 日）

对于 7 月 28 日之后的持续监测，您将在令牌达到 30 天未使用阈值之前的第 25 天和第 29 天收到电邮。所有电邮每天实行批处理，每天一封电邮列出所有受影响的令牌，而非一个令牌一封电邮。

“取消激活日期”列显示我的令牌将在 30 天后取消激活，但我仍在用。我在使用令牌期间，它真的会被取消激活吗？

不会。使用令牌会重置时钟。“取消激活日期”始终是令牌“最后使用”日期后的 30 天，因此每次您使用令牌时，“取消激活日期”都会向后推迟一天。只要您每 30 天至少使用一次令牌，它就不会取消激活。

  • 您每天使用的令牌会显示一个“取消激活日期”，该日期每天都会向后推移，因为每次使用都会更新“最后使用日期”。
  • 对于每月使用一次的令牌，只要每次使用都在当前“取消激活日期”之前，就可以继续使用。
  • 只有连续 30 天未使用的令牌在达到其“取消激活日期”后才会自动取消激活。

只要使用令牌，就能自行防止取消激活。无需管理员操作即可保持令牌处于活跃状态。如果 API 令牌取消激活，在令牌被删除前，您有 60 天的时间重新激活。

如何查看 API 令牌的详细使用量信息？

从 7 月 28 日起，您可以从 API 令牌页面生成使用量报告。该报告显示前 7 天使用 API 令牌发出的 API 请求，或最多 500MB 的数据，以先到者为准。定期生成报告，从而建立 30-60 天的滚动历史记录。

报告的每一行显示一个 API 请求，并包含以下信息：

  • 时间戳：发出请求的时间
  • 令牌标识符：已截断的令牌 ID
  • 令牌描述：API 令牌的描述（若提供）
  • IP 地址：请求的来源
  • 用户代理：发出请求的客户端/应用程序
  • 方法：HTTP 方法（GET、POST、PUT、DELETE 等）
  • URL：已访问的 API 端点
  • 状态代码：HTTP 响应代码（200、404、401 等）
  • 用户 ID 和电邮：电邮地址和令牌结合使用以发出 API 请求的用户

使用方法：

  • 每隔几天生成一次报告，建立 30-60 天的滚动历史记录
  • 使用 IP 地址和用户代理来识别各令牌对应的系统/脚本
  • 使用用户 ID 和电邮地址识别发出 API 请求的对象
  • 检查 URL 和方法列以了解令牌正在执行的操作
  • 交叉引用令牌标识符和令牌列表，确定哪个令牌需要迁移

哪些 API 令牌将被移除？

仅 Support API 令牌受到影响。消息传送、聊天和其他产品的 API 令牌不在此次更改范围内。

是否需要立即迁移所有令牌？

不需要，您可以逐步迁移整合。现有令牌继续有效，直到 2027 年 4 月 30 日强制取消激活。重点是关键任务型整合。

如果我有一个使用 API 令牌的第三方应用，怎么办？

对于市场应用：根据开发者政策，任何第三方应用、整合或智能机器人（无论是否列在 Zendesk 市场上）都不得使用客户的 API 凭证（API 令牌或客户自己的 OAuth 客户端）对 API 调用进行身份验证。迁移到 OAuth 的应用将继续运行。未迁移的应用将在 API 令牌取消激活时停止运行。

对于第三方创建的自定义应用：联系构建应用的开发者，让他们迁移到 OAuth。如果开发者已不存在，则需重建或寻找替代解决方案。

如果我的整合不经常（每月/每季度）运行怎么办？

如果您的令牌已有 30 天未使用，它将从 7 月 28 日起自动取消激活。您的工作流程下次运行时将失败，出现身份验证错误。

解决方法：

  • 立即查看您的令牌页面，识别将于 7 月 28 日取消激活的令牌（超过 30 天未使用的令牌）
  • 只要在 6 月 28 日至 7 月 28 日期间使用一次令牌，即可避免初始取消激活
  • 7 月 28 日之后，可通过使用量报告记录哪些令牌处于活跃状态
  • 如果工作流程失败，重新激活最近取消激活的令牌，并通过使用量报告来识别所需的令牌

如何得知哪个令牌导致 API 请求失败？

目前，失败的身份验证请求不会显示使用的是哪个特定令牌。如果您在取消激活后进行故障排除：

  1. 检查 API 令牌页面以了解最近取消激活的令牌。
  2. 重新激活所有的候选项（您有 60 天的时间）。
  3. 在您的工作流程运行后生成使用量报告，确定使用了哪个令牌。

如果我没有及时迁移，会怎样？

从 2027 年 4 月 30 日起，所有使用 API 令牌的 API 调用都会失败，并出现身份验证错误。影响取决于您使用 API 令牌的方式：

  • 工作流程停止执行
  • 工单不同步
  • 报告不运行
  • 自动流程失败

2027 年 4 月 30 日之后，不存在选择退出或延期的选项。所有整合都必须迁移到 OAuth。

为什么不改进 API 令牌，而将其移除？

OAuth 的安全改进功能（自动过期、轮换和范围限定）需要截然不同的身份验证模型。这些功能添加到 API 令牌实质上就是重新创建 OAuth，只不过换个名字而已。

此外，支持两种身份验证方法也会产生安全风险：

  • 客户会选择更简单的选项（API 令牌）而非更安全的选项 (OAuth)
  • 我们必须对两个系统进行安全防护改进和持续监控
  • 攻击者可能利用安全防护较弱的方法

若完全移除 API 令牌，我们可确保所有整合都能采用现代身份验证安全措施，而不是保留安全性较低的选项。

使用 API 令牌的 Webhook 怎么样？

本次停用后，对于回调至您自有 Zendesk 实例的 Webhook，系统不再支持使用 API 令牌，相关功能将同步失效。在诸多用例中，迁移到操作工作流程可能比迁移到 OAuth 更简单。如果您的 Webhook 需要回调到 Zendesk，并需要 OAuth 令牌刷新行为，您可能需要使用中间件或其他自定义实现，代表您处理身份验证。 

Zendesk 致力于在 2027 年 4 月截止日期之前添加对 Webhook 的原生 OAuth 支持，面向使用自引用 Webhook 的客户提供直接迁移路径。具体时间安排将在确定后另行公布。与此同时，操作工作流程涵盖众多 Webhook 用例，无需 OAuth。

什么是操作工作流程？

操作工作流程是用户定义的自动步骤序列，根据启动或触发工作流程的所定义事件在 Zendesk 和外部系统中执行操作。管理中心的“操作工作流程”页面包括一个可视化的工作流程生成器（称为操作生成器），用于创建和编辑这些工作流程。参阅了解操作生成器和操作流程，以及创建操作工作流程以自动在 Zendesk 和外部系统中执行流程，了解更多信息。

操作工作流程的优势：

  • Zendesk 操作不计入 Zendesk API 速率限制（但操作流程中的自定义操作会计入）
  • 可以将多个 Webhook 合并到一个工作流程中
  • 可扩展：在内部运营中添加第三方通话
  • 可视化工作流程生成器更易于创建和管理多系统工作流程

哪些 Webhook 适合进行操作工作流程迁移

  • 工单创建或更新操作
  • 用户创建或更新操作
  • 组织创建或更新操作
  • 自定义对象、任务、批准、ITAM 操作
  • 将 JSON 有效负载与标准 CRUD 操作结合使用的 Webhook
  • 支持大多数标准工单、用户和组织字段
  • 还支持所有自定义工单字段

操作流程自定义操作可以使用 API 令牌吗？

不可以。操作工作流程有两种身份验证模型：
  • Zendesk 操作。这些是工单、用户和组织等操作：
    • 不要求使用 API 令牌或 OAuth
    • 不占用 API 速率限制
    • 不受移除 Zendesk API 令牌的影响
  • 自定义操作和外部操作：
    • 需要明确通过身份验证（OAuth、API 令牌或基本身份验证）
    • 停用后，自定义操作所用的 Zendesk API 令牌将停止运行
    • 如果呼叫 Zendesk 端点，必须将自定义操作迁移到 OAuth
    • 如果您迁移到操作工作流程，并使用需要 OAuth 的自定义操作，操作工作流程将自动处理令牌刷新


 

如果您对此公告有任何反馈或疑问，请访问我们的社区论坛，我们在此收集和管理客户对产品的反馈。如需获取关于 Zendesk 产品的常规帮助，请联系 Zendesk 客户支持。

由 Zendesk 提供技术支持