API ViaShopModa documentação

categoria/cadastrar

Cadastrar gênero (categoria)

Cria um gênero pelo nome; se já existir, devolve o id do existente.

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

O que faz #

Cria um gênero (campo genero do produto). Se o nome já existir, não cria outro e devolve o id do existente.

Normalmente não é preciso chamar esta rota: produto/cadastrar cria o gênero pelo nome.

Requisição #

MétodoPOST
URLhttps://api.viashopmoda.com.br/via/categoria/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órioLimitesDescrição
nomestringsimmín. 2, máx. 30, gravado em MAIÚSCULAS

Regras #

  • Nome de 2 a 30 caracteres, gravado em MAIÚSCULAS.

Exemplo #

{ "nome": "Plus size" }

Criado:

{ "retorno": true, "cadastro": true, "nome": "PLUS SIZE", "id": 10 }

Já existia (não é erro — use o id):

{ "retorno": true, "cadastro": false, "msg_erro": "Categoria não cadastrada. Nome enviado já existe.", "nome": "PLUS SIZE", "id": "10" }

Erros: Parâmetro 'nome' em 'categoria/cadastrar' não encontrado, Categoria não cadastrado.

Pode reenviar? #

Sim. O reenvio devolve o id existente com cadastro: false.