Idempotência

Envie um header Idempotency-Key com um valor único por operação nos POST que cobram ou reservam créditos.

Uma nova tentativa de rede com a mesma key devolve o resultado original em vez de executar de novo (e cobrar ou reservar de novo).

Regras

• Obrigatório em POST /v1/batches (reserva créditos): 428 se faltar.
• Recomendado em POST /v1/generations.
• Reusar uma key com outro payload devolve 422 (você não recebe o resultado de outra operação); reusá-la em outro endpoint também. Use uma key distinta por operação.
• POST /v1/products (upsert) aceita o header, mas o upsert já é idempotente por SKU. Não reuse a mesma key com um lote diferente: devolveria as contagens em cache do primeiro sem gravar o novo.
• Uma operação ainda em andamento com essa key devolve 409: tente de novo em um momento.