请求幂等

适用读者客户开发者状态接口契约待发布适用版本首发规划版责任人开放平台团队最近复核2026-09-10

什么时候需要

创建码包、提交任务、创建订单或其他可能被网络重试的写操作需要幂等保护。

约定

每个业务意图生成一个不可猜测的幂等键；
相同键和相同请求摘要返回同一结果；
相同键但请求内容不同返回冲突；
超时后先查询原请求状态，不要立即换新键重复创建；
具体 Header 名称和有效期以正式 OpenAPI 为准。