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étodo | POST |
| URL | https://api.viashopmoda.com.br/via/categoria/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 | Limites | Descrição |
|---|---|---|---|---|
nome | string | sim | mí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.