网络调用可能失败。为了重试 POST 而不会重复执行任务、重复付费,请发送一个幂等键:为每个逻辑操作生成的唯一值(用 UUID 就很合适)。
curl -X POST https://developers.grem.capital/api/v1/valuation/express \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 3f1c8a90-1e2b-4c77-9a10-2b6d0f9e4a11" \
-d '{"propertyCategory":"apartment","totalArea":50}'
如何运作
- 使用某个键的第一次请求正常执行,其结果会被缓存。
- 使用同一个键的重复请求会返回最初的结果 — 工具不会再次运行,也不会再次扣费。
- 如果第一次请求仍在处理中,重复请求会返回
409(幂等冲突)— 请稍候重试。
键会被记住 24 小时。
每个不同的操作都要用新的键。把同一个键用于确实不同的请求,会让它们统统返回第一次的结果。