Zendesk Ticketing API：工单创建幂等规则

Zendesk 官方 Ticketing 引介展示 POST 创建工单与 Idempotency-Key：相同body/key在两小时内重试返回缓存，不同body报400。实际子域与认证、费率和限流在其它文档，本批未捕获；仅文档整理，未创建或发送工单。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：客户支持／Zendesk 工单创建与有限期幂等重试 · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · 171fbbdf2d0674d4d0eb0516301588fc3697162333acc05262c8a4577793357b

Support API可管理工单、用户、组织与工作流。本页多数通用机制转引到API introduction，唯一较完整例子是带幂等键创建工单；本卡据此聚焦两小时重试边界，不从导航推断其它具体操作契约。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-41970e2398ff78affc748cf7 · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-41970e2398ff78affc748cf7
名片版本: 2
资料更新: 2026-10-24T18:46:46.6855627+00:00
原作者 / 提供者: Zendesk
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

实际{subdomain}及ticket JSON，示例含subject和comment.body；不是完整创建工单schema。
Idempotency-Key header标识同一body的请求，重试需保持body和key一致。

输出

示例创建/缓存命中均返回201和ticket对象，包含url、id、subject等；首次x-idempotency-lookup=miss，重试为hit。
同key不同body返回400 IdempotentRequestError；幂等键不存入ticket响应。

使用方式

类型: HTTP 接口
入口: 未知
HTTP 方法: POST

鉴权：未知。认证要求转引到未捕获的general API introduction；本文curl用-u user:password作为示例，但不足以保证当前所有账户都支持该方式。未取得或使用任何账户凭据。

运行前提

需实际Zendesk子域与有创建工单权限的认证；本批无实际子域，entry_url留空。
POST JSON工单，可加Idempotency-Key唯一键用于有限期重试。
本次不注册账户/安装Postman、不认证、不读取或创建工单，不发送支持请求。

公开请求示例

{
  "body": {
    "ticket": {
      "comment": {
        "body": "My printer is offline. Restarting does not help."
      },
      "subject": "Printer offline"
    }
  },
  "headers": {
    "Content-Type": "application/json",
    "Idempotency-Key": "\u003Cunique-key\u003E"
  },
  "method": "POST",
  "notes": "\u4F9D\u636E\u5B98\u65B9\u5E42\u7B49\u4F8B\u5B50\u6574\u7406\uFF0C\u5B50\u57DF/\u771F\u5B9E\u8BA4\u8BC1\u672A\u63D0\u4F9B\uFF0C\u672A\u6267\u884C\u3002",
  "url_template": "https://{subdomain}.zendesk.com/api/v2/tickets.json"
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。Ticketing引介未列API/账户费用、免费额度或计划条件；Postman免费账号介绍不属于Zendesk计费证据。

价格来源 · 未知

资料去向

提供者服务器。工单主题/评论与账户信息由Zendesk处理，幂等响应缓存两小时的键生命周期不等于工单数据保留期限。完整日志/工单保留政策未在本页说明，本次未提交内容。

限制

幂等键两小时后过期；过期后重复key请求会创建新工单，不能作永久去重保证。
同key必须匹配相同body，否则400；201本身不能区分新建与缓存，应查看lookup header。
认证、速率、请求/响应通用格式、分页与数据类型均转引其它页面，本附件不完整。
实际工单操作会写入账户并可能触发工作流，本次完全未执行。

仍需核对

实际子域、当前认证方式/账户权限、完整创建请求与响应schema未知。
API/账号计划费用、数值限流/配额、SLA和工单/日志保留未知。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T18:45:53.6603314+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

Ticketing | Zendesk Developer Docs · 官方文档 · 2026-10-25T02:45:53.6603314+08:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://developer.zendesk.com/api-reference/ticketing/introduction/",
  "final_url": "https://developer.zendesk.com/api-reference/ticketing/introduction/",
  "status_code": 200,
  "title": "Ticketing | Zendesk Developer Docs",
  "description": "Developer documentation for products at Zendesk",
  "checked_at": "2026-10-24T18:45:53.6603314\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-41970e2398ff78affc748cf7",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://developer.zendesk.com/api-reference/ticketing/introduction/"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。