Pular para o conteúdo principal

Imagens no Modelo de Anúncios da API V3

Atendimento
Atualizado

Neste artigo, mostraremos como inserir links de imagem no modelo de anúncio através da API V3 da Ideris. Acompanhe o passo a passo e descubra como realizar de forma prática.

Para criar um modelo de anúncio utilizando a API V3 do Ideris, é obrigatório associar pelo menos uma imagem por SKU. Contudo, essas imagens precisam atender a critérios específicos.

 

Regras para as Imagens

  1. Não pode ser uma imagem local.
    • Imagens armazenadas diretamente no seu computador não são aceitas.
  2. Deve estar hospedada na nuvem, mas não em drives pessoais.
    • Serviços como Google Drive, OneDrive ou iCloud não são suportados.
  3. Não pode estar alocada em sistemas fechados.
    • Links provenientes de ERPs, hubs ou sistemas internos na nuvem não funcionarão.
  4. Precisa ser um link público.
    • A imagem deve estar hospedada em sites que permitem acesso direto ao arquivo final no formato JPEG ou JPG.
    • Exemplos de sites aceitos: Imgur ou outros serviços que gerem URLs públicas.

Exemplos de Links

Exemplo incorreto:

https://smart.sgisistemas.com.br/ecommerce/integracoes/imagem/Mlm%2F+FdB9+SJXB20e3fknMuKcA%2F3qOY95pAOxlni3Tk=.jpeg

Por quê não funciona?

  • O link direciona para a página de login do ERP antes de acessar a imagem.
  • Resultado: A API retorna erro porque a imagem não possui autorização de acesso.

Exemplo correto:

https://i.imgur.com/6ixoDNs.jpg

Por quê funciona?

  • A imagem está hospedada em um site público, sem necessidade de autenticação.
  • Isso permite que o Painel Ideris processe o upload corretamente.

Base64 no Modelo de Anúncio

Caso utilize imagens no formato Base64, a propriedade 'base64' será validada usando a seguinte expressão regular (regex):

^data:(?image/(png|tiff|jpg|jpeg|gif));base64,(?[A-Z0-9+/=]+)$

Nota: Certifique-se de que o formato Base64 siga exatamente esse padrão para evitar erros na integração.

Documentação Eletrônica

A documentação completa da API está disponível em um ambiente eletrônico no endereço Swagger.

  • Acesso: Não é necessário token para consultar essa documentação.
  • Objetivo: Retornar exemplos de objetos padrão, permitindo que você teste as integrações sem precisar de credenciais de acesso.

Se precisar de mais ajuda com este processo, nossa equipe de suporte está pronta para atender você. É só clicar no ícone do whatsapp no canto inferior direito de qualquer página do seu painel Ideris ou abrir um ticket. 

Conte sempre conosco. Até a próxima!

Artigos relacionados