API ViaShopModa documentação

estampa/cadastrar

Cadastrar estampas (cores/variações)

Cria estampas em lote pelo nome; as que já existem são devolvidas sem alteração.

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

O que faz #

Cria estampas (a "cor" da variação). Nomes que já existem entre as estampas ativas vêm em nao_cadastrados, com o id existente.

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

Requisição #

MétodoPOST
URLhttps://api.viashopmoda.com.br/via/estampa/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
nomestringsimmín. 3, máx. 50Nome da estampa

Regras #

  • Nome de 3 a 50 caracteres.
  • A estampa nasce sem imagem. Para dar uma imagem, use imagens/upload com o objeto estampa; para uma cor sólida, estampa/atualizar com hex.

Exemplo #

[ { "nome": "VERMELHO CEREJA" }, { "nome": "NUDE" } ]
{
  "retorno": true,
  "total": 2,
  "cadastrados": [ { "id": "500", "nome": "VERMELHO CEREJA" } ],
  "nao_cadastrados": [ { "id": "10", "nome": "NUDE" } ]
}

Erros: POST enviado não é um 'array', 'nome' da estampa enviado é inválido ou vazio., Estampa não cadastrada.

Pode reenviar? #

Sim; as existentes vêm em nao_cadastrados.