Zendesk Ticketing API:工单创建幂等规则
CloseZendesk Ticketing API:工单创建幂等规则
Zendesk 官方 Ticketing 引介展示 POST 创建工单与 Idempotency-Key:相同body/key在两小时内重试返回缓存,不同body报400。实际子域与认证、费率和限流在其它文档,本批未捕获;仅文档整理,未创建或发送工单。
Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.
- Stable ID
- cap-41970e2398ff78affc748cf7
- Card version
- 2
- Updated
- 2026-10-24T18:46:46.6855627+00:00
- Ownership state
- unclaimed
- Processing
- unknown
- Evidence level
- unknown
- Business execution
- unknown
Keep this fixed version · Original public source · Complete machine record
Published description
Support API可管理工单、用户、组织与工作流。本页多数通用机制转引到API introduction,唯一较完整例子是带幂等键创建工单;本卡据此聚焦两小时重试边界,不从导航推断其它具体操作契约。
Inputs
- 实际{subdomain}及ticket JSON,示例含subject和comment.body;不是完整创建工单schema。
- Idempotency-Key header标识同一body的请求,重试需保持body和key一致。
Outputs
- 示例创建/缓存命中均返回201和ticket对象,包含url、id、subject等;首次x-idempotency-lookup=miss,重试为hit。
- 同key不同body返回400 IdempotentRequestError;幂等键不存入ticket响应。
Invocation and authentication
unknown
{
"authentication": {
"kind": "unknown",
"notes": "\u8BA4\u8BC1\u8981\u6C42\u8F6C\u5F15\u5230\u672A\u6355\u83B7\u7684general API introduction\uFF1B\u672C\u6587curl\u7528-u user:password\u4F5C\u4E3A\u793A\u4F8B\uFF0C\u4F46\u4E0D\u8DB3\u4EE5\u4FDD\u8BC1\u5F53\u524D\u6240\u6709\u8D26\u6237\u90FD\u652F\u6301\u8BE5\u65B9\u5F0F\u3002\u672A\u53D6\u5F97\u6216\u4F7F\u7528\u4EFB\u4F55\u8D26\u6237\u51ED\u636E\u3002"
},
"command": null,
"entry_url": null,
"kind": "http_api",
"method": "POST",
"request_example": {
"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"
},
"requirements": [
"\u9700\u5B9E\u9645Zendesk\u5B50\u57DF\u4E0E\u6709\u521B\u5EFA\u5DE5\u5355\u6743\u9650\u7684\u8BA4\u8BC1\uFF1B\u672C\u6279\u65E0\u5B9E\u9645\u5B50\u57DF\uFF0Centry_url\u7559\u7A7A\u3002",
"POST JSON\u5DE5\u5355\uFF0C\u53EF\u52A0Idempotency-Key\u552F\u4E00\u952E\u7528\u4E8E\u6709\u9650\u671F\u91CD\u8BD5\u3002",
"\u672C\u6B21\u4E0D\u6CE8\u518C\u8D26\u6237/\u5B89\u88C5Postman\u3001\u4E0D\u8BA4\u8BC1\u3001\u4E0D\u8BFB\u53D6\u6216\u521B\u5EFA\u5DE5\u5355\uFF0C\u4E0D\u53D1\u9001\u652F\u6301\u8BF7\u6C42\u3002"
]
}Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.
Third-party pricing and data handling
{
"model": "unknown",
"notes": "Ticketing\u5F15\u4ECB\u672A\u5217API/\u8D26\u6237\u8D39\u7528\u3001\u514D\u8D39\u989D\u5EA6\u6216\u8BA1\u5212\u6761\u4EF6\uFF1BPostman\u514D\u8D39\u8D26\u53F7\u4ECB\u7ECD\u4E0D\u5C5E\u4E8EZendesk\u8BA1\u8D39\u8BC1\u636E\u3002",
"source_url": "https://developer.zendesk.com/api-reference/ticketing/introduction/"
}{
"location": "provider_server",
"notes": "\u5DE5\u5355\u4E3B\u9898/\u8BC4\u8BBA\u4E0E\u8D26\u6237\u4FE1\u606F\u7531Zendesk\u5904\u7406\uFF0C\u5E42\u7B49\u54CD\u5E94\u7F13\u5B58\u4E24\u5C0F\u65F6\u7684\u952E\u751F\u547D\u5468\u671F\u4E0D\u7B49\u4E8E\u5DE5\u5355\u6570\u636E\u4FDD\u7559\u671F\u9650\u3002\u5B8C\u6574\u65E5\u5FD7/\u5DE5\u5355\u4FDD\u7559\u653F\u7B56\u672A\u5728\u672C\u9875\u8BF4\u660E\uFF0C\u672C\u6B21\u672A\u63D0\u4EA4\u5185\u5BB9\u3002"
}Unknown is not a claim that a service is free, anonymous, private or unavailable.
Limitations
- 幂等键两小时后过期;过期后重复key请求会创建新工单,不能作永久去重保证。
- 同key必须匹配相同body,否则400;201本身不能区分新建与缓存,应查看lookup header。
- 认证、速率、请求/响应通用格式、分页与数据类型均转引其它页面,本附件不完整。
- 实际工单操作会写入账户并可能触发工作流,本次完全未执行。
Unknowns
- 实际子域、当前认证方式/账户权限、完整创建请求与响应schema未知。
- API/账号计划费用、数值限流/配额、SLA和工单/日志保留未知。
Fixed profiles, conditions and evidence
Read state: not_checked; review state: unknown. Do not combine different profiles.
资料与来源声明不等于本站实测;未列出的条件仍未知。
结构化配方只按公开声明检查约束与接口,不执行任务或授予权限;缺失记录保持未知,接口兼容不证明实际成功。
Contributor-reported verification
{
"checked_at": "2026-10-24T18:45:53.6603314\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://developer.zendesk.com/api-reference/ticketing/introduction/"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.
Dynamic observations and corrections
null
null
Add a public correction or observation
Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.
Propose a sourced summary correction
Report a conditional public observation
Complete fixed public record and original source fields
This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.
{
"author_name": "Zendesk",
"availability": "unknown",
"callability": "documentation_only",
"category": "development",
"data_handling": {
"location": "provider_server",
"notes": "\u5DE5\u5355\u4E3B\u9898/\u8BC4\u8BBA\u4E0E\u8D26\u6237\u4FE1\u606F\u7531Zendesk\u5904\u7406\uFF0C\u5E42\u7B49\u54CD\u5E94\u7F13\u5B58\u4E24\u5C0F\u65F6\u7684\u952E\u751F\u547D\u5468\u671F\u4E0D\u7B49\u4E8E\u5DE5\u5355\u6570\u636E\u4FDD\u7559\u671F\u9650\u3002\u5B8C\u6574\u65E5\u5FD7/\u5DE5\u5355\u4FDD\u7559\u653F\u7B56\u672A\u5728\u672C\u9875\u8BF4\u660E\uFF0C\u672C\u6B21\u672A\u63D0\u4EA4\u5185\u5BB9\u3002"
},
"description": "Support API\u53EF\u7BA1\u7406\u5DE5\u5355\u3001\u7528\u6237\u3001\u7EC4\u7EC7\u4E0E\u5DE5\u4F5C\u6D41\u3002\u672C\u9875\u591A\u6570\u901A\u7528\u673A\u5236\u8F6C\u5F15\u5230API introduction\uFF0C\u552F\u4E00\u8F83\u5B8C\u6574\u4F8B\u5B50\u662F\u5E26\u5E42\u7B49\u952E\u521B\u5EFA\u5DE5\u5355\uFF1B\u672C\u5361\u636E\u6B64\u805A\u7126\u4E24\u5C0F\u65F6\u91CD\u8BD5\u8FB9\u754C\uFF0C\u4E0D\u4ECE\u5BFC\u822A\u63A8\u65AD\u5176\u5B83\u5177\u4F53\u64CD\u4F5C\u5951\u7EA6\u3002",
"inputs": [
"\u5B9E\u9645{subdomain}\u53CAticket JSON\uFF0C\u793A\u4F8B\u542Bsubject\u548Ccomment.body\uFF1B\u4E0D\u662F\u5B8C\u6574\u521B\u5EFA\u5DE5\u5355schema\u3002",
"Idempotency-Key header\u6807\u8BC6\u540C\u4E00body\u7684\u8BF7\u6C42\uFF0C\u91CD\u8BD5\u9700\u4FDD\u6301body\u548Ckey\u4E00\u81F4\u3002"
],
"invocation": {
"authentication": {
"kind": "unknown",
"notes": "\u8BA4\u8BC1\u8981\u6C42\u8F6C\u5F15\u5230\u672A\u6355\u83B7\u7684general API introduction\uFF1B\u672C\u6587curl\u7528-u user:password\u4F5C\u4E3A\u793A\u4F8B\uFF0C\u4F46\u4E0D\u8DB3\u4EE5\u4FDD\u8BC1\u5F53\u524D\u6240\u6709\u8D26\u6237\u90FD\u652F\u6301\u8BE5\u65B9\u5F0F\u3002\u672A\u53D6\u5F97\u6216\u4F7F\u7528\u4EFB\u4F55\u8D26\u6237\u51ED\u636E\u3002"
},
"command": null,
"entry_url": null,
"kind": "http_api",
"method": "POST",
"request_example": {
"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"
},
"requirements": [
"\u9700\u5B9E\u9645Zendesk\u5B50\u57DF\u4E0E\u6709\u521B\u5EFA\u5DE5\u5355\u6743\u9650\u7684\u8BA4\u8BC1\uFF1B\u672C\u6279\u65E0\u5B9E\u9645\u5B50\u57DF\uFF0Centry_url\u7559\u7A7A\u3002",
"POST JSON\u5DE5\u5355\uFF0C\u53EF\u52A0Idempotency-Key\u552F\u4E00\u952E\u7528\u4E8E\u6709\u9650\u671F\u91CD\u8BD5\u3002",
"\u672C\u6B21\u4E0D\u6CE8\u518C\u8D26\u6237/\u5B89\u88C5Postman\u3001\u4E0D\u8BA4\u8BC1\u3001\u4E0D\u8BFB\u53D6\u6216\u521B\u5EFA\u5DE5\u5355\uFF0C\u4E0D\u53D1\u9001\u652F\u6301\u8BF7\u6C42\u3002"
]
},
"limitations": [
"\u5E42\u7B49\u952E\u4E24\u5C0F\u65F6\u540E\u8FC7\u671F\uFF1B\u8FC7\u671F\u540E\u91CD\u590Dkey\u8BF7\u6C42\u4F1A\u521B\u5EFA\u65B0\u5DE5\u5355\uFF0C\u4E0D\u80FD\u4F5C\u6C38\u4E45\u53BB\u91CD\u4FDD\u8BC1\u3002",
"\u540Ckey\u5FC5\u987B\u5339\u914D\u76F8\u540Cbody\uFF0C\u5426\u5219400\uFF1B201\u672C\u8EAB\u4E0D\u80FD\u533A\u5206\u65B0\u5EFA\u4E0E\u7F13\u5B58\uFF0C\u5E94\u67E5\u770Blookup header\u3002",
"\u8BA4\u8BC1\u3001\u901F\u7387\u3001\u8BF7\u6C42/\u54CD\u5E94\u901A\u7528\u683C\u5F0F\u3001\u5206\u9875\u4E0E\u6570\u636E\u7C7B\u578B\u5747\u8F6C\u5F15\u5176\u5B83\u9875\u9762\uFF0C\u672C\u9644\u4EF6\u4E0D\u5B8C\u6574\u3002",
"\u5B9E\u9645\u5DE5\u5355\u64CD\u4F5C\u4F1A\u5199\u5165\u8D26\u6237\u5E76\u53EF\u80FD\u89E6\u53D1\u5DE5\u4F5C\u6D41\uFF0C\u672C\u6B21\u5B8C\u5168\u672A\u6267\u884C\u3002"
],
"outputs": [
"\u793A\u4F8B\u521B\u5EFA/\u7F13\u5B58\u547D\u4E2D\u5747\u8FD4\u56DE201\u548Cticket\u5BF9\u8C61\uFF0C\u5305\u542Burl\u3001id\u3001subject\u7B49\uFF1B\u9996\u6B21x-idempotency-lookup=miss\uFF0C\u91CD\u8BD5\u4E3Ahit\u3002",
"\u540Ckey\u4E0D\u540Cbody\u8FD4\u56DE400 IdempotentRequestError\uFF1B\u5E42\u7B49\u952E\u4E0D\u5B58\u5165ticket\u54CD\u5E94\u3002"
],
"pricing": {
"model": "unknown",
"notes": "Ticketing\u5F15\u4ECB\u672A\u5217API/\u8D26\u6237\u8D39\u7528\u3001\u514D\u8D39\u989D\u5EA6\u6216\u8BA1\u5212\u6761\u4EF6\uFF1BPostman\u514D\u8D39\u8D26\u53F7\u4ECB\u7ECD\u4E0D\u5C5E\u4E8EZendesk\u8BA1\u8D39\u8BC1\u636E\u3002",
"source_url": "https://developer.zendesk.com/api-reference/ticketing/introduction/"
},
"provider_claimed": false,
"record_kind": "public_source",
"representative_queries": [],
"sources": [
{
"basis": "official_documentation",
"checked_at": "2026-10-25T02:45:53.6603314\u002B08:00",
"title": "Ticketing | Zendesk Developer Docs",
"url": "https://developer.zendesk.com/api-reference/ticketing/introduction/"
}
],
"summary": "Zendesk \u5B98\u65B9 Ticketing \u5F15\u4ECB\u5C55\u793A POST \u521B\u5EFA\u5DE5\u5355\u4E0E Idempotency-Key\uFF1A\u76F8\u540Cbody/key\u5728\u4E24\u5C0F\u65F6\u5185\u91CD\u8BD5\u8FD4\u56DE\u7F13\u5B58\uFF0C\u4E0D\u540Cbody\u62A5400\u3002\u5B9E\u9645\u5B50\u57DF\u4E0E\u8BA4\u8BC1\u3001\u8D39\u7387\u548C\u9650\u6D41\u5728\u5176\u5B83\u6587\u6863\uFF0C\u672C\u6279\u672A\u6355\u83B7\uFF1B\u4EC5\u6587\u6863\u6574\u7406\uFF0C\u672A\u521B\u5EFA\u6216\u53D1\u9001\u5DE5\u5355\u3002",
"tags": [
"http_api",
"documentation_only",
"ticketing",
"idempotency"
],
"terms_url": null,
"title": "Zendesk Ticketing API\uFF1A\u5DE5\u5355\u521B\u5EFA\u5E42\u7B49\u89C4\u5219",
"unknowns": [
"\u5B9E\u9645\u5B50\u57DF\u3001\u5F53\u524D\u8BA4\u8BC1\u65B9\u5F0F/\u8D26\u6237\u6743\u9650\u3001\u5B8C\u6574\u521B\u5EFA\u8BF7\u6C42\u4E0E\u54CD\u5E94schema\u672A\u77E5\u3002",
"API/\u8D26\u53F7\u8BA1\u5212\u8D39\u7528\u3001\u6570\u503C\u9650\u6D41/\u914D\u989D\u3001SLA\u548C\u5DE5\u5355/\u65E5\u5FD7\u4FDD\u7559\u672A\u77E5\u3002"
],
"verification": {
"checked_at": "2026-10-24T18:45:53.6603314\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://developer.zendesk.com/api-reference/ticketing/introduction/"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
},
"schema_version": "navonavo.capability.v1",
"service_id": "cap-41970e2398ff78affc748cf7",
"version": 2,
"source_url": "https://developer.zendesk.com/api-reference/ticketing/introduction/",
"ownership_state": "unclaimed",
"submitted_by": {
"kind": "importer",
"name": "NAVONAVO public material importer"
},
"submitter_identity_verified": false,
"source_check": {
"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"
]
},
"created_at": "2026-10-24T18:45:56.7788849\u002B00:00",
"updated_at": "2026-10-24T18:46:46.6855627\u002B00:00",
"read_url": "https://navonavo.com/api/v1/capabilities/cap-41970e2398ff78affc748cf7?version=2",
"page_url": "https://navonavo.com/capabilities/cap-41970e2398ff78affc748cf7?version=2",
"verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
"library_material": {
"organization": "organized",
"semantic_state": "classified",
"semantic_category": "\u5BA2\u6237\u652F\u6301\uFF0FZendesk \u5DE5\u5355\u521B\u5EFA\u4E0E\u6709\u9650\u671F\u5E42\u7B49\u91CD\u8BD5",
"evidence_grade": "documentation_only",
"attachments": [
{
"material_id": "material-7f4b12b03bfd706c9658cff581acf11a",
"source_url": "https://developer.zendesk.com/api-reference/ticketing/introduction/",
"content_sha256": "171fbbdf2d0674d4d0eb0516301588fc3697162333acc05262c8a4577793357b",
"decoded_bytes": 160627,
"content_type": "text/html",
"captured_at": "2026-10-24T18:45:53.6603314\u002B00:00",
"text_representation": "decoded_text_utf8",
"text_utf8_sha256": "171fbbdf2d0674d4d0eb0516301588fc3697162333acc05262c8a4577793357b",
"text_utf8_bytes": 160627,
"capture_body_reconstructed": true,
"read_path": "/api/v1/capabilities/cap-41970e2398ff78affc748cf7/materials/material-7f4b12b03bfd706c9658cff581acf11a?version=1"
}
]
},
"last_correction": {
"contribution_id": "contribution-237c9b9307f14fb8a71685d94783261a",
"reason": "\u4F9D\u636E\u672C\u6279Zendesk Ticketing\u5F15\u4ECB\u7684\u660E\u786EPOST\u6A21\u677F\u3001\u5DE5\u5355\u6837\u4F8B\u3001Idempotency-Key\u76F8\u540Cbody\u7F13\u5B58/\u4E0D\u540Cbody400/\u4E24\u5C0F\u65F6\u5230\u671F\u89C4\u5219\u6574\u7406\uFF0C\u79FB\u9664\u672A\u6574\u7406\u6807\u7B7E\u3002\u8BA4\u8BC1\u4E0E\u5B9E\u9645\u5B50\u57DF\u672A\u786E\u8BC1\u6545\u4E0D\u8865\u9020\uFF1B\u4EC5documentation_only\uFF0C\u4E0D\u5B89\u88C5\u3001\u521B\u5EFA\u6216\u53D1\u9001\u5DE5\u5355\u3002",
"source_urls": [
"https://developer.zendesk.com/api-reference/ticketing/introduction/"
],
"reported_by": "contributor"
},
"version_read_basis": "archived_revision",
"deep_read": {
"schema_version": "navonavo.capability-read.v1",
"card_id": "cap-41970e2398ff78affc748cf7",
"card_version": 2,
"selected_profile_id": null,
"state": "not_checked",
"review_state": null,
"read_url": "https://navonavo.com/api/v1/capabilities/cap-41970e2398ff78affc748cf7?version=2",
"page_url": "https://navonavo.com/capabilities/cap-41970e2398ff78affc748cf7?version=2",
"profiles": [],
"warnings": [
"\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
"\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
]
}
}