ДокументацияИдемпотентность
Идемпотентность
Как не создать и не оплатить запрос дважды.
Сеть рвётся: запрос мог дойти, а ответ — нет. Чтобы повтор не создал второй ролик и не списал деньги дважды, передавайте заголовок Idempotency-Key:
-H "Idempotency-Key: order-1842-video"
- Ключ — от 8 до 128 печатных символов ASCII: UUID или ваш номер заказа.
- Повтор с тем же ключом возвращает первый запрос с заголовком
Idempotent-Replayed: true— без новой генерации и списания. - Если первый запрос ещё создаётся, повтор получит
409 idempotency_conflict— повторите через пару секунд. - Если первый запрос не был создан или модель отказалась его запускать (ответ с ошибкой), ключ свободен: повтор с ним создаёт запрос заново.
- Ключ действует для аккаунта навсегда: новый ролик — новый ключ.