> ## Documentation Index
> Fetch the complete documentation index at: https://docs.speedsellx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Idempotência

> Use Idempotency-Key em requisições que alteram dados

Toda requisição que altera dados precisa do header HTTP `Idempotency-Key`.

Use uma chave única para cada operação. Se precisar repetir a mesma operação por falha de rede, envie a mesma chave e o mesmo corpo da requisição.

Um UUID é uma boa escolha para a chave.

```bash theme={null}
curl -X POST https://api.speedsellx.io/seller/v1/products \
  -H "Authorization: Bearer $SPEEDSELLX_API_KEY" \
  -H "Idempotency-Key: 6b3a8f2e-2a1b-4c9d-9f1e-7a0c2d4e5f60" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Curso de Vendas", "price": 199.9 }'
```

## Erros comuns

<ResponseField name="422 idempotency_key_required">
  A requisição altera dados, mas foi enviada sem `Idempotency-Key`.
</ResponseField>

<ResponseField name="409 idempotency_in_progress">
  Já existe uma requisição com essa chave em processamento. Aguarde alguns instantes e tente novamente.
</ResponseField>

<ResponseField name="409 idempotency_key_reuse">
  A chave já foi usada com outro corpo. Gere uma nova chave para uma operação diferente.
</ResponseField>

<Note>
  Não reutilize a mesma `Idempotency-Key` para operações diferentes.
</Note>