SITUAÇÃO:
Alguns clientes desejam integrar sistemas externos ao Sankhya e precisam exibir as imagens dos produtos em suas aplicações.
Embora o produto possua imagem vinculada no cadastro, muitos usuários não sabem qual rota utilizar, como interpretar a resposta retornada pela API ou como salvar o arquivo recebido.
OBSERVAÇÃO:
Até o momento, a integração de imagens está disponível apenas pela API legada, não havendo suporte para esse recurso na API pública.
SOLUÇÃO:
Monte a URL da imagem.
Utilize o padrão da API legada para obter a imagem do produto:
https://api.sankhya.com.br/gateway/v1/mge/Produto@IMAGEM@CODPROD=<CODPROD>.dbimage
Exemplo:
https://api.sankhya.com.br/gateway/v1/mge/Produto@IMAGEM@CODPROD=2.dbimage
Substitua <CODPROD> pelo código do produto desejado.
Envie uma requisição GET no Postman.
Configurações de requisição:
Método: GET
URL: conforme o padrão ou exemplo acima
Headers recomendados:
Authorization: Bearer XXXXXX (Substitua XXXXX pelo token válido gerado previamente)
Content-Type: image/jpeg
Body: selecione a opção None
Nenhum parâmetro adicional é necessário.
Interprete o retorno.
Ao executar a rota, a API retornará a imagem em formato binário.
Se o Postman estiver exibindo no modo JSON, o contéudo pode aparecer assim:
ÿØÿà JFIF ...
Isso é esperado e indica que a imagem foi retornada de forma correta.
Salve e visualiza a imagem
Clique em ''Save Response to file'' e salve o arquivo com uma extensão de imagem, como:
produto.jpg
Depois de salvar, basta abrir o arquivo - a imagem será exibida normalmente.
CAUSA:
A integração de imagens no Sankhya funciona por meio do endpoint .dbimage, que sempre retorna o arquivo em formato binário.
Dessa forma, o sistema externo apenas recebe esse conteúdo e pode salvá-lo ou exibi-lo diretamente, sem necessidade de realizar conversões adicionais.
Esse método garante que qualquer aplicação consiga consumir as imagens de forma rápida e padronizada.
Comentários
0 comentário
Escreva seu comentário aqui
Por favor, entre para comentar.