A entidade Imagens do Produto permite gerenciar as imagens dos produtos no Mercos. É possível escolher entre duas formas de envio:
- URL da imagem
- Imagem convertida em Base64
Importante
- Só é possível cadastrar imagens, não sendo possível excluí-las através da API.
- É obrigatório enviar pelo menos um dos parâmetros. Caso os dois parâmetros sejam informados o sistema irá considerar apenas a URL da imagem. Importante destacar que os formatos indicados são
.jpeg,.jpge.png.
Parâmetros de Envio (POST)
| Campo | Tipo | Descrição |
|---|---|---|
| MeusPedidosID | Integer | Identificador único da imagem na Mercos. |
| MEUSPEDIDOS_QTDE_TOTAL_REGISTROS | Integer | Valor será sempre 0 nesse método. |
Parâmetros do JSON de envio da Imagem
| Campo | Tipo | Descrição |
|---|---|---|
| produto_id (obrigatório) | Integer | Identificador único do Produto na Mercos. |
| ordem | Integer | Ordem que as imagens serão exibidas na Mercos. Sendo 1 a imagem principal. |
| imagem_url | String: 500 | URL pública da imagem. |
| imagem_base64 | String | Imagem convertida em Base64. |
É obrigatório informar um dos seguintes campos: imagem_url ou imagem_base64.
Estrutura da Resposta (GET)
| Campo | Tipo | Descrição |
|---|---|---|
| produto_id | Integer | Identificador único do Produto na Mercos. |
| imagens | Array<String> | Lista de hashes (SHA-512) das imagens ativas do produto. |
Geração do hash
O hash das imagens é gerado utilizando o algoritmo SHA-512 sobre o conteúdo binário original da imagem (antes de qualquer processamento como redimensionamento). Para comparar localmente, calcule o SHA-512 do arquivo da imagem que deseja enviar e compare com os valores retornados pela API.
Exemplo em Python:
import hashlib with open("imagem.png", "rb") as f: hash_imagem = hashlib.sha512(f.read()).hexdigest()