跳到主要内容

幂等性

对于写操作接口(如创建下发单),需要在请求中携带 X-Request-No 防止重复提交。

请求头

请求头说明
x-api-keyAPI Token
Content-Typeapplication/json
X-Request-No客户端生成的唯一请求编号(建议使用 UUID)

幂等性说明

服务端会根据 X-Request-No 进行去重校验:

  • 同一 X-Request-No 的请求在 24 小时内不会被重复处理
  • 重复请求将直接返回首次请求的响应结果
  • 请确保每次新请求使用唯一的编号(建议使用 UUID v4)
  • 超过 24 小时后,相同的 X-Request-No 可以再次使用