API ViaShopModa documentação

colecao/cadastrar

Cadastrar coleção

Cria uma coleção pelo nome; se já existir uma ativa com esse nome, devolve o id dela.

Ver como Markdown Baixar coleção Postman Atualizado em 18/11/2026

O que faz #

Cria uma coleção ativa. Se já existir uma coleção ativa com o mesmo nome, devolve o id dela sem criar outra.

Normalmente não é preciso: produto/cadastrar cria a coleção pelo nome.

Requisição #

MétodoPOST
URLhttps://api.viashopmoda.com.br/via/colecao/cadastrar/{TOKEN}
CorpoObjeto JSON { ... }, cabeçalho Content-Type: application/json
TokenSubstitua {TOKEN} pelo token da loja. Ele vai no caminho da URL, não em cabeçalho.

Campos #

CampoTipoObrigatórioDescrição
nometextosim3 a 40 caracteres, gravado em MAIÚSCULAS.

Regras #

  • A busca por nome considera só coleções ativas: se existir uma inativa com o mesmo nome, uma nova é criada.

Exemplo #

{ "nome": "Inverno 2026" }
{ "retorno": true, "cadastro": true, "msg": "Coleção cadastrada com sucesso.", "id": 34, "nome": "INVERNO 2026" }

Já existia: retorno: true, cadastro: false, com msg_erro explicando e o id existente. Erros: Parâmetro 'nome' não encontrado, Coleção não cadastrada.

Pode reenviar? #

Sim; devolve o id da coleção ativa existente.