Skip to main content
Quase todos os erros vêm neste envelope:
Trate pelo error.code, não pelo texto de message. O message muda por recurso — um 409 de coleção não fala de produto.

​
Códigos

Cada rota da referência lista só os status que ela devolve. 409 DUPLICATE_ENTRY aparece em criação de produto, coleção, cupom e desconto por pagamento. Um 404 não confirma se o id existe em outra loja. Use o X-Store-Id correto.

​
Limite de requisições

429 pode trazer Retry-After (segundos). Por minuto: Faça backoff. Não dispare um loop em 429.
Falhas repetidas de autenticação também são limitadas. Se a chave estiver errada, pause antes de tentar de novo.

​
Idempotência na criação

No POST você pode enviar:
Use 1 a 128 caracteres (A–Z, a–z, 0–9, ., _, -). O mesmo valor em até 24 horas devolve o mesmo produto, com Idempotent-Replayed: true.