API do Demander - Anexos do Produto

Este artigo faz parte da documentação da API de Integração REST.

Documentação para consultar, inserir, atualizar e excluir anexos de produto.

Consulta

Lista os anexos de um produto.

Rota: {host}/public/v1/anexos-do-produto?codProduto={codProduto}
Método: GET

Retorno:

[
  {
    "codIntegracao": "ANX001",
    "codProduto": "PROD-100",
    "tipoAnexo": "imagem",
    "titulo": "Foto principal",
    "descricao": "Imagem da frente do produto",
    "nomeArquivo": "imagem_frente.jpg",
    "urlExterna": null,
    "ordem": 1,
    "dataAlteracao": "2026-07-15 10:00:00"
  }
]

Inserir ou atualizar

POST upsert pela chave codIntegracao.

Rota: {host}/public/v1/anexos-do-produto
Método: POST
Body: form/data

Propriedade	Tipo	Tamanho	Obrigatório	Descrição
codIntegracao	string	15	✓	Identificador único do anexo no ERP. Chave de upsert.
codProduto	string	50	✓	Código do produto ao qual o anexo pertence.
codProdutoGrade	string	30		Código da grade do produto (tabela 25).
tipoAnexo	string	20	✓	Opções: `video`, `imagem`, `documento`, `url`.
titulo	string	255		Título do anexo (ex.: `Manual do Produto`).
descricao	string	2000		Descrição do conteúdo ou propósito do anexo.
nomeArquivo	string	255	✓	Nome do arquivo no download, com extensão. Opcional quando `tipoAnexo` é `url`.
metodoArmazenamento	int		✓	`1` — upload no Demander (`arquivo` ou `urlExterna` para cópia). `2` — armazenamento externo (exige `urlExterna`).
urlExterna	string	255		URL pública do arquivo. Obrigatória se não enviar `arquivo`, ou quando `metodoArmazenamento=2`. Não informar junto com `arquivo`.
arquivo	file			Arquivo multipart. Usado com `metodoArmazenamento=1`. Máximo 100 MB. Não informar junto com `urlExterna`.
ordem	int			Ordem de exibição do anexo.

Retorno:

{
  "mensagem": "Anexo do produto criado com sucesso.",
  "codIntegracao": "ANX001"
}

Excluir

Remove o anexo.

Rota: {host}/public/v1/anexos-do-produto?codIntegracao={codIntegracao}
Método: DELETE

Retorno:

{
  "mensagem": "Registro excluído com sucesso."
}