用途:通过 Zendesk REST API 管理 Zendesk Support 中的工单、用户、组织,并执行搜索。
主要能力:列出工单、创建工单、按条件搜索工单等,接口返回 JSON,可配合 jq 提取字段。
使用方式:需设置环境变量 ZENDESK_SUBDOMAIN(子域名,如 mycompany)、ZENDESK_EMAIL(坐席邮箱)、ZENDESK_API_TOKEN(API 令牌)。请求使用基本认证,格式为 "$ZENDESK_EMAIL/token:$ZENDESK_API_TOKEN",基础地址为 https://$ZENDESK_SUBDOMAIN.zendesk.com/api/v2/。
示例:列出工单 curl -s -u "$ZENDESK_EMAIL/token:$ZENDESK_API_TOKEN" "https://$ZENDESK_SUBDOMAIN.zendesk.com/api/v2/tickets?per_page=10" | jq '.tickets[] | {id, subject, status, priority}';创建工单使用 POST /api/v2/tickets,请求体为 {"ticket":{"subject":"Issue","description":"Details","priority":"normal"}};搜索使用 /api/v2/search?query=type:ticket%20status:open。
适用场景:需要以脚本或自动化方式批量查看、创建、检索 Zendesk 工单与相关记录时。
限制:资料未提供用户、组织的具体接口示例,也未说明权限范围、速率限制、错误处理与计费信息;创建或更新工单前应始终确认。