Primeiros passos
Leitura
Leia o recurso antes de editá-lo e informe expected_version conforme documentado.
Escrita
Use POST para criar recursos aceitos, PATCH para atualizações parciais e DELETE para eliminações aceitas.
Resposta
Repetir uma operação bem-sucedida retorna o resultado armazenado sem aplicar a alteração novamente.
Cabeçalhos
- Idempotency-Key
- Toda escrita de recursos exige Idempotency-Key. Gere uma chave por operação lógica; repita a mesma chave, método, destino e conteúdo ao tentar essa operação novamente.
- expected_version
- Alterações de preços também podem exigir versões do produto, preço, preços de variantes ou lista de preços. Se uma versão mudar, leia novamente e concilie a atualização, em vez de impor dados antigos.
Política de novas tentativas
- Reutilizar uma chave para outra requisição produz idempotency.key_reused.
- Todos os exemplos são sintéticos; substitua os identificadores por valores obtidos da sua própria loja antes de executá-los.