VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API legada/Guia rápido/Produtos

GETConsultar um produto

Consulta os detalhes de um produto pelo ID, com características, categorias e variações.

Use este endpoint para obter as informações detalhadas de um produto pelo ID. A resposta inclui atributos, características, variações, categorias e mais.

GET/api/Products/{product_id}Seller

Consulta os detalhes de um produto

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).

Parâmetros de caminho

product_idstringobrigatório
ID do produto a consultar.

Exemplo de requisição

bash
curl "$BASE_URL/api/Products/977451" \
  -u "$EMAIL:$API_KEY"

Resposta

O endpoint devolve as informações detalhadas do produto: atributos, características, variações, categorias e mais.

200Produto encontrado
json
{
  "product_id": "977451",
  "product": "Athletic Shoes Blue",
  "product_code": "7898953436099",
  "amount": 75,
  "price": "129.90",
  "list_price": "149.90",
  "status": "A",
  "weight": "350",
  "short_description": "Comfortable athletic shoes for everyday use",
  "full_description": "Lightweight athletic shoes made with breathable materials perfect for running, walking or casual wear.",
  "product_features": {
    "16": "94",
    "14": "95",
    "20": "Unisex",
    "18": "SportBrand",
    "7": "Synthetic"
  },
  "main_category": "1384",
  "category_ids": [
    "1384",
    "1459"
  ],
  "category_names": [
    "Footwear",
    "Sports"
  ],
  "images": [
    {
      "image_id": "95198",
      "image_path": "https://example.com/images/products/shoes-blue.png",
      "is_main": true
    },
    {
      "image_id": "95199",
      "image_path": "https://example.com/images/products/shoes-blue-side.png",
      "is_main": false
    }
  ],
  "variation_group_id": "123",
  "variation_group_code": "ATHLETIC_SHOES",
  "variations": [
    {
      "product_id": "977451",
      "variation_features": {
        "573": "Blue",
        "575": "42"
      }
    },
    {
      "product_id": "977452",
      "variation_features": {
        "573": "Red",
        "575": "42"
      }
    }
  ],
  "brand": "SportBrand",
  "company_id": "32",
  "company_name": "Sports Distribution Inc."
}

Campos da resposta

product_idstring
Identificador único do produto.
productstring
Nome do produto.
product_codestring
Código universal do produto (código de barras).
amountnumber
Quantidade disponível em estoque.
pricestring
Preço de venda atual.
list_pricestring
Preço original (antes de descontos).
statusstring
Status do produto (A ativo, D desativado, H oculto).
product_featuresobject
Pares chave-valor com o ID da característica e o valor dela.
variation_group_idstring
ID do grupo de variações a que o produto pertence.
variationsarray
Lista das variações do produto (cor, tamanho etc.).
Dica

Ao trabalhar com variações, use o variation_group_id para identificar os produtos da mesma família (por exemplo, o mesmo produto em cores ou tamanhos diferentes).

Veja também

  • Consultar produtos
  • Criar grupo de variações
  • Visão geral de produtos
Anterior
Criar grupo de variações
Próxima
Vender um produto
Nesta página
  • Exemplo de requisição
  • Resposta
  • Veja também