对于写操作接口(如创建下发单),需要在请求中携带 X-Request-No 防止重复提交。
请求头
| 请求头 | 说明 |
|---|
x-api-key | API Token |
Content-Type | application/json |
X-Request-No | 客户端生成的唯一请求编号(建议使用 UUID) |
幂等性说明
服务端会根据 X-Request-No 进行去重校验:
- 同一
X-Request-No 的请求在 24 小时内不会被重复处理
- 重复请求将直接返回首次请求的响应结果
- 请确保每次新请求使用唯一的编号(建议使用 UUID v4)
- 超过 24 小时后,相同的
X-Request-No 可以再次使用