Поведение ключа
http
Idempotency-Key: order-8493-shot-1Ключ содержит 1–255 видимых ASCII-символов и уникален внутри проекта.
| Повтор | Результат |
|---|---|
| Те же ключ и тело запроса | Возвращается исходный ответ с Idempotent-Replayed: true |
| Тот же ключ, другое тело запроса | 409 idempotency_conflict |
| Без ключа | Каждый POST создаёт новую платную генерацию |
Когда повторять
- После
202сохраняйте ID и проверяйте статус. - Если ответ на POST потерян, повторите то же тело запроса с тем же ключом.
- POST без ключа нельзя автоматически повторять.
- GET можно повторять; при ошибках постепенно увеличивайте интервал.
Неопределённый статус
При submission_unknown не создавайте новую генерацию: первая уже может быть принята и тарифицироваться.