Trabalhando com características

Este guia mostra como trabalhar com as características de um produto pela API. As características permitem definir atributos específicos dos produtos e são uma forma de dar aos clientes especificações detalhadas, que eles podem usar para filtrar e comparar produtos.

API de características do produto

Consultar as características de um produto

Exemplo de requisição

curl "$BASE_URL/api/products/14/features" \
  -u "$EMAIL:$API_KEY"

Esta requisição retorna todas as características do produto com product_id=14.

Criar um produto com uma característica

Ao criar um produto, você pode definir as características dele na mesma requisição. Este exemplo adiciona ao novo produto uma característica de texto (tipo T) com feature_id=23.

Exemplo de requisição

curl -X POST "$BASE_URL/api/products" \
  -u "$EMAIL:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product": "New Product",
  "category_ids": "223",
  "main_category": "223",
  "price": "10",
  "status": "A",
  "product_features": {
    "23": {
      "feature_type": "T",
      "value": "Test"
    }
  }
}'

Esta requisição cria um novo produto com o valor "Test" na característica de texto.

Resposta de sucesso

{
  "product_id": 250
}

Atualizar uma característica de um produto

Exemplo de requisição

curl -X PUT "$BASE_URL/api/products/250" \
  -u "$EMAIL:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_features": {
    "23": {
      "feature_type": "T",
      "value": "Feature updated"
    }
  }
}'

Esta requisição atualiza o produto com product_id=250 e altera para "Feature updated" o valor da característica de texto com feature_id=23.

Resposta de sucesso

{
  "product_id": 250
}

Veja também

• Campos
• Endpoints de produtos