Consultar e gerenciar a Galeria pela API
Liste e remova mídias com segurança e reconheça os limites do contrato público antes de tentar automatizar o upload de arquivos.
Antes de começar
- API ativa
- Arquivo fictício e sem dados pessoais para homologação
- Permissão para remover apenas mídias de teste
Conhecer o que está publicado
- GET /v2/api/external/{ApiID}/gallery/list aceita pageNumber e fileType.
- POST .../gallery/upload publica somente description em um corpo JSON.
- POST .../gallery/delete/{id} usa corpo vazio e remove o item selecionado.
- Não há rota pública de download nessa família auditada.

Listar e identificar uma mídia
- 1
Comece pela primeira pageNumber disponível no ambiente de homologação.
- 2
Use fileType somente depois de confirmar os valores aceitos pela versão atual.
- 3
Registre internamente o schema real da resposta, pois ele não está detalhado publicamente.
- 4
Compare o identificador e os metadados efetivamente retornados pela versão com a Galeria antes de usar o registro em outra operação.
Entender por que o upload exige cautela
- 1
Abra a documentação interativa da API no próprio ambiente.
- 2
Confira se a versão atual expõe o campo de arquivo e o Content-Type esperado.
- 3
Teste um arquivo pequeno, fictício e sem metadados pessoais.
- 4
Reliste a Galeria e confira o item na interface.
- 5
Se o contrato continuar incompleto, faça o upload pela interface e use a API apenas para consulta controlada.
Excluir uma mídia de teste
- 1
Reliste e confirme o ID imediatamente antes da exclusão.
- 2
Verifique se a mídia não está em mensagem rápida, campanha, template ou automação.
- 3
Chame gallery/delete/{id} somente para o item de homologação conhecido.
- 4
Reliste e confirme a remoção na interface.
- 5
Se houver timeout, consulte antes de repetir.
Se ainda houver dúvida, continue pelos artigos relacionados abaixo.
