是否可以使用 API 将文件附加到工单？

问题

是否可以使用 Zendesk API 将文件（例如照片）附加到工单？

回答

可以，当文件附加到工单时，如果帐户需要身份验证才能下载附件，则附件仅对有权访问工单的用户可见。在附件与工单关联之前，任何已通过身份验证的用户都可以使用其 content_URL。附件的密钥将在 60 分钟后过期。

因此，您需要

1. 使用上传文件 API 端点，该端点会返回一个密钥。
2. 在创建或更新工单时，通过 uploads 数组将密钥包括在工单评论中。如果不完成此步骤，Zendesk 将删除已上传的文件，并在上传密钥过期时显示 404 not found 出错消息。

例如

{
  "ticket": {
    "comment":  { "body": "See screenshot.", "uploads":  ["vz7ll9ud8oofowy"] }
  }
}

注意：私密附件可用于终端用户和工单受托人的消息传送工单。此类附件具有更高级别的安全性，用户对此类附件的访问权限有限。

提示：如果某些文件扩展名上传失败，可能是因为管理员通过管理中心的“允许的文件类型”设置对帐户中可上传的文件类型进行了限制。这些限制适用于工单附件，包括通过 API 上传的文件。有关更多信息，请参阅以下文章：将工单附件限制为 Zendesk 推荐的文件类型