Мережеві виклики іноді падають. Щоб повторити 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 години.
Використовуйте новий ключ для кожної окремої операції. Повторне використання одного ключа для справді різних запитів поверне для всіх них результат першого.