Docs

幂等性

最后更新: 2026-07-21阅读约 2 分钟

网络调用可能失败。为了重试 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 小时。

每个不同的操作都要用新的键。把同一个键用于确实不同的请求,会让它们统统返回第一次的结果。

这篇文章对您有帮助吗?