用户可使用 API 密钥对 API 请求进行身份验证。API 密钥是自动生成的密码，可以和您的电邮地址相结合，用于对 API 请求进行身份验证，或用于对整合进行双重身份验证。每个 API 令牌可供帐户中通过验证的用户使用，并非与特定用户关联。您可以同时激活多个密钥。

我的服务模式是什么？
所有 Suite： Team、Growth、Professional、Enterprise 或 Enterprise Plus
Support Team、Professional 或 Enterprise

已验证人工智能概要 ◀▼

通过生成、编辑、取消激活、重新激活或删除 API 密钥，管理对 Zendesk 帐户的 API 访问。在 Enterprise 服务模式中，查看密钥活动的审核日志。 

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

用户可使用 API 密钥对 API 请求进行身份验证。API 密钥是自动生成的密码，可以和您的电邮地址相结合，用于对 API 请求进行身份验证，或用于对整合进行双重身份验证。每个 API 令牌可供帐户中通过验证的用户使用，并非与特定用户关联。您可以同时激活多个密钥。

您最多可以有 256 个密钥。如果已达到上限，则必须删除现有密钥才能添加新密钥。若帐户当前拥有的密钥超过 256 个，则该帐户的密钥上限为 2048。

API 密钥与 OAuth 访问密钥不同。请参阅 developer.zendesk.com 上的 API 密钥和访问密钥之间的区别。

本文章包含以下部分：

  • 生成 API 密钥
  • 编辑 API 密钥
  • 取消激活和重新激活 API 密钥
  • 删除 API 密钥
  • 查看 API 密钥的审核日志 (Enterprise)

生成 API 密钥

要生成 API 密钥，您必须是管理员，并且必须在帐户中启用 API 密钥访问。

生成 API 密钥的步骤

  1. 在管理中心，单击侧栏中的应用和整合 ()，然后选择 API > API 密钥。

    随即显示 API 密钥列表。

  2. 单击添加 API 密钥。
  3. （可选）为密钥输入描述。
  4. 单击保存以生成密钥。

    密钥随即生成并显示。

  5. 复制密钥并将其粘贴到安全的地方。
    注意：当您单击保存关闭此窗口时，完整密钥将不再显示。
  6. 再次单击保存返回到 Zendesk API 密钥列表。

    如果您单击密钥将其重新打开，则会显示该密钥的删节版本。

编辑 API 密钥

您可编辑 API 密钥以更新密钥描述。

编辑 API 密钥
  1. 在管理中心，单击侧栏中的应用和整合 ()，然后选择 API > API 密钥。
  2. 找到您要编辑的密钥。
  3. 单击密钥旁边的选项菜单图标 ()，然后选择编辑。
  4. 为密钥输入新描述，然后单击保存。

取消激活和重新激活 API 密钥

在某些情况下，您可能想暂时停用密钥，以确保其不被泄露，或者您可能想停用密钥，以调查其使用方式，而实际上并未将其删除。已取消激活的密钥可以重新激活。

取消激活 API 密钥

  1. 在管理中心，单击侧栏中的应用和整合 ()，然后选择 API > API 密钥。
  2. 找到您要取消激活的密钥。
  3. 单击密钥旁边的选项菜单图标 ()，然后选择取消激活。

  4. 在确认对话框中，选择取消激活。

    密钥状态随即更改。取消激活密钥后，使用密钥的 API 调用即会失败。

重新激活 API 密钥
  1. 在管理中心，单击侧栏中的应用和整合 ()，然后选择 API > API 密钥。
  2. 找到您要重新激活的密钥。
  3. 单击密钥旁边的选项菜单图标 ()，然后选择取消激活。
  4. 在确认对话框中，单击重新激活。

    密钥状态随即从已取消激活更改为活跃。重新激活密钥将恢复其对 API 请求进行身份验证的功能。

删除 API 密钥

API 密钥就像密码：帐户中任何已通过验证的用户或任何知道其电邮地址的人都可以使用它对 API 请求进行身份验证。如果您发现 API 密钥已泄露，请立即将其删除。删除密钥是永久性操作。此操作不可撤销。
注意：您必须先取消激活密钥，然后才能将其删除。
删除 API 密钥
  1. 在管理中心，单击侧栏中的应用和整合 ()，然后选择 API > API 密钥。
  2. 找到您要删除的密钥，并确保其状态为已取消激活。
  3. 单击密钥旁边的选项菜单图标 ()，然后选择删除。

  4. 在确认对话框中，单击删除。

查看 API 密钥的审核日志 (Enterprise)

在 Enterprise 服务模式中，审核日志记录了 API 密钥相关活动，包括其创建、取消激活或重新激活时间。

查看审核日志
  1. 在管理中心，单击侧栏中的应用和整合 ()，然后选择 API > API 密钥。
  2. 在列表中找到密钥。
  3. 单击密钥旁边的选项菜单图标 ()，然后选择查看审核日志。

    审核日志随即打开，并将筛选应用于所选 API 密钥。审核日志显示密钥相关活动。

翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性

如对翻译准确性有任何疑问，请以文章的英语版本为准。

由 Zendesk 提供技术支持