VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API legada/Guia rápido/Variações e opções

Criar grupo de variações

O que a API legada faz e não faz com variações; a rota de criação de grupo existe, mas responde 501.

A Venddor 1.0 tinha um endpoint para criar um grupo de variações a partir de uma lista de produtos e de características. A rota foi mantida para que clientes antigos não recebam 404, mas não está implementada: depois de validar o corpo, ela sempre responde 501 Not Implemented e nada é criado.

Por esta API você só consulta opções e filhos: Opções do produto e Variações.

Não use em integrações

Não construa integrações novas sobre POST /product_variations: ela nunca cria nada. Para organizar variações, cadastre os produtos filhos pelo painel da loja e consulte-os com Variações.

Criar grupo de variações (não implementado)

POST/api/v1.0/product_variationsAdmin

Criar um grupo de variações (não implementado)

Autenticação: HTTP Basic (e-mail:chave_de_api) de um administrador, ou Authorization: Bearer <JWT>. Também responde em /api/product_variations.

A rota lê o corpo e confere se os três campos vieram preenchidos. Se faltar algum, responde 400. Se vierem todos, responde 501.

Corpo da requisição

product_idsarrayobrigatório
Ids dos produtos que formariam o grupo. Pelo menos um.
codestringobrigatório
Código do grupo.
featuresobjectobrigatório
Mapa de características, não vazio ({"<id da característica>": "<id do valor>"}).

Exemplo de requisição

bash
curl -X POST "$BASE_URL/api/v1.0/product_variations" \
  -u "$EMAIL:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_ids":["id-1","id-2"],"code":"CAM","features":{"1":"2"}}'

Resposta

501Não implementado
json
{
  "message": "variation group creation via the compatibility API is not implemented",
  "status": 501
}

Erros

StatusQuandoExemplo de corpo
400Corpo não é JSON{"message":"invalid request body","status":400}
400product_ids, code ou features vazios{"message":"product_ids, code, and features are required","status":400}
401Sem credenciais{"message":"Authentication required. Use HTTP Basic with email:api_key or Bearer <jwt>.","status":401}
501Corpo válido{"message":"variation group creation via the compatibility API is not implemented","status":501}

Veja também

  • Visão geral de variações e opções
  • Variações
Anterior
Exceções de opções
Próxima
Preço e estoque do produto
Nesta página
  • Criar grupo de variações (não implementado)
  • Exemplo de requisição
  • Resposta
  • Erros
  • Veja também