Novidades
Search
K

Novo endpoint para gestão das imagens dos produtos

Publicado no dia 18/01/2023
Estamos disponibilizamos um novo endpoint em nossa API para cadastro, atualização e remoção das imagens dos produtos. Atualmente, a gestão dessas imagens é realizada pelo endpoint products e/ou variants, com a utilização dos campos "picture_source_x".
Mantivemos os mesmos campos e estrutura, porém em um novo endpoint denominado images. Em breve, descontinuaremos esses campos "picture_souce_id" da API products e variants, mantendo apenas no endpoint images.
Por isso, é importante que você faça todas as adaptações e implementações até o dia 2 de julho de 2023.
Confira todas as mudanças!

Nova Gestão de imagens através do endpoint images

✅ Produto

Método POST (Cadastro e Atualização): https://{{api_address}}/products/{id_do_produto}/images?access_token={{access_token}}
Exemplo do código:
'{ "Images": { "picture_source_1":"http://bancodeimagens/imagem1.jpg", "picture_source_2":"http://bancodeimagens/imagem2.jpg", "picture_source_3":"http://bancodeimagens/imagem3.jpg", "picture_source_4":"http://bancodeimagens/imagem4.jpg", "picture_source_5":"http://bancodeimagens/imagem5.jpg", "picture_source_6":"http://bancodeimagens/imagem6.jpg", "picture_source_7":"http://bancodeimagens/imagem7.jpg", "picture_source_8":"http://bancodeimagens/imagem8.jpg", "picture_source_9":"http://bancodeimagens/imagem9.jpg", "picture_source_10":"http://bancodeimagens/imagem10.jpg", "picture_source_11":"http://bancodeimagens/imagem11.jpg", "picture_source_12":"http://bancodeimagens/imagem12.jpg", "picture_source_13":"http://bancodeimagens/imagem13.jpg", "picture_source_14":"http://bancodeimagens/imagem14.jpg", "picture_source_15":"http://bancodeimagens/imagem15.jpg"
}
}'
Resposta:
{ "message": "Uploaded images", "code": 200 }
📝 Clique aqui e acesse a documentação completa.

✅ Variações

Método POST (Cadastro e Atualização): https://{{api_address}}/variants/{id_da_variacao}/images?access_token={{access_token}}
Exemplo do código:
'{ "Images": { "picture_source_1":"http://bancodeimagens/imagem1.jpg", "picture_source_2":"http://bancodeimagens/imagem2.jpg", "picture_source_3":"http://bancodeimagens/imagem3.jpg", "picture_source_4":"http://bancodeimagens/imagem4.jpg", "picture_source_5":"http://bancodeimagens/imagem5.jpg", "picture_source_6":"http://bancodeimagens/imagem6.jpg", "picture_source_7":"http://bancodeimagens/imagem7.jpg", "picture_source_8":"http://bancodeimagens/imagem8.jpg", "picture_source_9":"http://bancodeimagens/imagem9.jpg", "picture_source_10":"http://bancodeimagens/imagem10.jpg", "picture_source_11":"http://bancodeimagens/imagem11.jpg", "picture_source_12":"http://bancodeimagens/imagem12.jpg", "picture_source_13":"http://bancodeimagens/imagem13.jpg", "picture_source_14":"http://bancodeimagens/imagem14.jpg", "picture_source_15":"http://bancodeimagens/imagem15.jpg"
"picture_source_x":" " } }'
Resposta:
{ "message": "Uploaded images", "code": 200 }
📝 Clique aqui e acesse a documentação completa.

✅ Remoção de Imagens (exclusão)

A remoção da imagem no cadastro do produto será realizada ao recebermos na requisição um espaço em branco entre aspas no lugar da URL, referente a posição da imagem que se pretende remover.
Exemplo: Remover imagem da posição 3 do produto id 1234.
Método POST: https://{{api_address}}/products/1234/images?access_token={{access_token}}
'{ "Images": { "picture_source_3":" " } }'
Observação: Assim que realizado o envio, as imagens serão processadas em fila, podendo levar alguns minutos para serem exibidas no cadastro do produto.
📝 Clique aqui e acesse a documentação completa.

✅ Regras sobre o cadastro e atualização das imagens

Quantidade: até 15 imagens; • Formatos: JPG, JPEG e PNG; • Dimensão: limite máximo de 2000 x 2000 pixels; • Tamanho: até 350 Kb; • URL: deverá ser de acesso público, não conter espaços, acentuação ou caracteres especiais; • Nome: não enviar a imagem com o nome já utilizado anteriormente.
Ficou com dúvidas? Você pode falar com nossos especialistas no canal de atendimento para parceiros.