Novo parâmetro para consulta de imagens na API Pública

Anteriormente, a plataforma aplicava de forma automatizada e fixa o parâmetro de redimensionamento de 800x800px nas URLs de mídias enviadas. Isso gerava distorções, compressão de qualidade e a inserção de bordas brancas indesejadas (efeito canvas) quando integradores como a Anymarket transmitiam fotos originalmente gravadas em formatos retangulares.

Essa limitação técnica impactava diretamente a experiência visual do consumidor final e elevava a taxa de rejeição de catálogos em marketplaces exigentes, que demandam proporções específicas de imagem para aprovação de anúncios.

Para solucionar, disponibilizamos um novo parâmetro opcional na API Pública que confere ao integrador controle total sobre a resolução da imagem a ser consultada, permitindo o envio das mídias em suas proporções e resoluções originais.

A lógica de dados foi estruturada da seguinte forma através do campo imagemOriginal:

• imagemOriginal: false: Retorna a URL da imagem com o redimensionamento e a compressão automática tradicional de 800x800px.
• imagemOriginal: true: Retorna a URL da imagem limpa, mantendo rigorosamente as dimensões, alta resolução e a proporção nativa do arquivo de cadastro.

Ao efetuar a chamada de leitura no endpoint GET/produtos/{identificador}/imagens, o integrador parceiro poderá declarar o parâmetro imagemOriginal = true para isolar e consumir o link da foto sem nenhuma alteração forçada de tamanho.

Principais Benefícios para a Operação

• Imagens em Alta Resolução: Os anúncios são transmitidos aos marketplaces preservando 100% da fidelidade e da qualidade visual de copywriting do produto.
• Eliminação de Bordas Brancas: Sem a imposição do redimensionamento quadrado, mitiga-se a necessidade de preenchimento de espaços vazios com fundos artificiais pelas integradoras.
• Maior Taxa de Aprovação de Catálogos: Lojistas dos segmentos de moda e vestuário ganham expressiva agilidade e segurança jurídica para aprovarem seus produtos em canais restritivos, como a Dafiti.
• Compatibilidade e Retrocompatibilidade: Como a alteração foi desenhada sob o modelo opt-in, o comportamento padrão (false) permanece inalterado. Isso garante zero impacto ou quebras de código para os demais integradores que já utilizam a API ativa.

Ainda sobrou alguma dúvida ou quer entender todos os detalhes de configuração e começar a aplicar agora mesmo? Confira o passo a passo completo na nossa documentação oficial:

🔗 Consultando uma Lista de Imagens de um Produto

Publicado em 13/07/2026