API ViaShopModa documentação

categoria/consultar

Consultar gêneros (categorias)

Lista os gêneros da loja (Feminino, Masculino, Infantil…). Na API, gênero = categoria.

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

O que faz #

Lista os gêneros — o campo genero do produto. A rota se chama categoria por motivo histórico (veja o Glossário).

Requisição #

MétodoGET
URLhttps://api.viashopmoda.com.br/via/categoria/consultar/{TOKEN}
CorpoNenhum. Filtros vão na query string (?campo=valor&...).
TokenSubstitua {TOKEN} pelo token da loja. Ele vai no caminho da URL, não em cabeçalho.

Parâmetros #

Todos os parâmetros são opcionais e vão na query string. Use um filtro por vez, salvo quando a descrição disser para combinar.

ParâmetroDescrição
idId do gênero.
nomeNome exato do gênero. Se vierem id e nome, vale o nome.

Exemplo #

curl "https://api.viashopmoda.com.br/via/categoria/consultar/SEU_TOKEN?nome=FEMININO"
{
  "retorno": true,
  "categoria": [
    { "id": "1", "nome": "FEMININO", "seo_title": "", "seo_description": "", "seo_h1": "", "foto": "", "tag": "feminino" }
  ]
}

Nada encontrado: retorno: false.

Pode reenviar? #

Sim (somente leitura).

Onde entra no processo #

Opcional na carga do catálogo: produto/cadastrar aceita o nome do gênero e cria se não existir.