Skip to main content
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.
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

422 idempotency_key_required
A requisição altera dados, mas foi enviada sem Idempotency-Key.
409 idempotency_in_progress
Já existe uma requisição com essa chave em processamento. Aguarde alguns instantes e tente novamente.
409 idempotency_key_reuse
A chave já foi usada com outro corpo. Gere uma nova chave para uma operação diferente.
Não reutilize a mesma Idempotency-Key para operações diferentes.