POSTCriar grupo de variações

Cria um grupo de variações para exibir produtos relacionados na mesma página de produto.

Use este endpoint para criar um grupo de variações, que reúne produtos relacionados (por exemplo, o mesmo produto em cores ou tamanhos diferentes). Os produtos do grupo aparecem na mesma página de produto e o cliente alterna entre as variações.

POST/api/ProductVariationsSeller

Cria um grupo de variações

Cabeçalhos

Authorizationstringobrigatório

Basic Auth. Combinação usuário:senha codificada em Base64 (o e-mail e a chave de API do Seller Center).

Corpo da requisição

product_idsarrayobrigatório

Array com os IDs dos produtos que entram no grupo de variações.

codestringobrigatório

Identificador único do grupo de variações.

featuresarrayobrigatório

Array com as características que definem as variações (por exemplo, cor e tamanho).

feature_idnumberobrigatório

ID da característica (por exemplo, 573 para cor e 575 para tamanho).

purposestringobrigatório

group_catalog_item

Sempre "group_catalog_item" para variações de produto.

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/ProductVariations" \
  -u "$EMAIL:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_ids": [
    977463,
    977465
  ],
  "code": "MY_GROUP_h1",
  "features": [
    {
      "feature_id": 573,
      "purpose": "group_catalog_item"
    },
    {
      "feature_id": 575,
      "purpose": "group_catalog_item"
    }
  ]
}'

Resposta

O endpoint devolve as informações do grupo de variações recém-criado.

200Grupo criado

json

{
  "variation_group_id": "123",
  "status": "success",
  "message": "Variation group created successfully"
}

Veja também