Produtos
Atualizar Produto
Aprenda a atualizar produtos usando o endpoint PUT /stores//products/.
PUT
Update product
📌 Endpoint
PUT /stores/{storeId}/products/{productId}
Atualiza os dados de um produto existente.
🔐 Autenticação
- Rota privada.
- Requer header
Authorizationcom sua API key e plano ativo.
🧾 Parâmetros de rota
🧍 Body (JSON)
Todos os campos são opcionais (enviarnull mantém o valor atual do campo), mas devem respeitar as regras abaixo quando enviados:
name(3-32)image(string até 512 caracteres; enviar""remove a imagem, enquantonullmantém inalterada)description(12-256)categoryIds(array de IDs de categorias da loja)delivery(DIGITALouPHYSICAL)price(0.5 a 9999)stock(inteiro -1 a 9999,-1ilimitado)disabled(trueoufalse)position(inteiro maior ou igual a 1)metadata(objeto)
✅ Exemplo de requisição
Snippet padrao (cURL)
Use o exemplo cURL da secao Exemplo de requisicao acima como snippet oficial.📦 Resposta de sucesso (200)
⚠️ Possíveis erros
400 INVALID_DATA→ body, parâmetros ou item decategoryIdsinválido400 INVALID_DATA_NAME_MIN→namecom menos de 3 caracteres400 INVALID_DATA_NAME_MAX→namecom mais de 32 caracteres400 INVALID_DATA_IMAGE→imagecom mais de 512 caracteres400 INVALID_DATA_DESCRIPTION_MIN→descriptioncom menos de 12 caracteres400 INVALID_DATA_DESCRIPTION_MAX→descriptioncom mais de 256 caracteres400 INVALID_DATA_DELIVERY→deliverydiferente deDIGITALouPHYSICAL400 INVALID_DATA_PRICE→pricefora do intervalo0.5a9999400 INVALID_DATA_STOCK→stockfora do intervalo-1a9999400 INVALID_DATA_POSITION→positionmenor que1400 CATEGORY_NOT_FOUND→ uma ou mais categorias emcategoryIdsnão encontradas na loja400 NAME_ALREADY_EXISTS→ nome já utilizado401 API_KEY_NOT_PROVIDED→ headerAuthorizationnão enviado (ouTOKEN_NOT_PROVIDEDvia Bearer)401 INVALID_API_KEY→ API Key inválida (ouINVALID_TOKEN/TOKEN_EXPIRED/SESSION_NOT_FOUND/SESSION_EXPIRED/UNAUTHENTICATEDvia Bearer)403 USER_DISABLED→ usuário desativado ou excluído403 NO_ACTIVE_SUBSCRIPTION→ plano inativo ou expirado (ouPENDING_2FAvia Bearer)404 STORE_NOT_FOUND→ loja não encontrada404 PRODUCT_NOT_FOUND→ produto não encontrado429 RATE_LIMIT_EXCEEDED→ limite de requisições por minuto excedido500 INTERNAL_SERVER_ERROR→ erro interno503 SERVICE_UNAVAILABLE→ serviço ou banco de dados indisponível
Parâmetros de caminho
Corpo
application/json
Product fields to update.