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étodo | POST |
| URL | https://api.viashopmoda.com.br/via/colecao/cadastrar/{TOKEN} |
| Corpo | Objeto JSON { ... }, cabeçalho Content-Type: application/json |
| Token | Substitua {TOKEN} pelo token da loja. Ele vai no caminho da URL, não em cabeçalho. |
Campos #
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
nome | texto | sim | 3 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.