API ViaShopModa documentação

grade/cadastrar

Cadastrar grades (tamanhos)

Cria tamanhos em lote pelo nome; tamanhos já existentes têm a descrição atualizada.

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

O que faz #

Para cada item: se não existe grade com o nome, cria; se existe, atualiza a descrição (aparece em alterados).

Normalmente não é preciso: produto/cadastrar cria as grades pelo nome.

Requisição #

MétodoPOST
URLhttps://api.viashopmoda.com.br/via/grade/cadastrar/{TOKEN}
CorpoLista JSON [ {...}, {...} ], até 20 itens por requisição, cabeçalho Content-Type: application/json
TokenSubstitua {TOKEN} pelo token da loja. Ele vai no caminho da URL, não em cabeçalho.

Campos #

O corpo é uma lista [ {...}, {...} ] com no máximo 20 itens. Cada item tem os campos abaixo.

CampoTipoObrigatórioLimitesDescrição
nomestringsimNome da grade. Ex.: 'XG'
descricaostringnãoaceita nullInformação adicional para a grade. Ex.: 'Extra G'

Exemplo #

[ { "nome": "P" }, { "nome": "EXG", "descricao": "Extra GG" } ]
{
  "retorno": true,
  "total": 2,
  "cadastrados": [ { "id": "20", "nome": "EXG", "descricao": "Extra GG" } ],
  "alterados": [ { "id": "14", "nome": "P", "descricao": "" } ]
}

Erros: POST enviado não é um 'array', Grade não cadastrada.

Pode reenviar? #

Sim. Atenção: para uma grade que já existe, os dados enviados são regravados — envie sempre a descricao desejada junto com o nome.