VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API legada/Referência completa/Combinações de opções

Obter uma combinação de opções

Retorna os detalhes de uma combinação de opções, identificada pelo hash.

Este endpoint retorna informações detalhadas de uma combinação de opções específica de um produto, a partir do identificador único (hash) dela. Se a requisição for bem-sucedida, você recebe HTTP/1.1 200 OK e uma resposta JSON com os detalhes da combinação.

GET/api/combinations/{combination_hash}Admin

Obter uma combinação de opções específica

Parâmetros de caminho

combination_hashstringobrigatório
O hash identificador único da combinação de opções.

Exemplo de requisição

bash
curl -u "$EMAIL:$API_KEY" "$BASE_URL/api/combinations/822274303"

Resposta

200Combinação de opções
json
{
  "combination_hash": "822274303",
  "product_id": "12",
  "product_code": "PRD-XY123-SM-BLU",
  "combination": {
    "3": "12",  // Option 3 (Size) = Variant 12 (Small)
    "4": "17"   // Option 4 (Color) = Variant 17 (Blue)
  },
  "amount": "10",
  "position": 0,
  "image_pairs": {
    "808": {
      "pair_id": "808",
      "image_id": "0",
      "detailed_id": "864",
      "position": "0",
      "detailed": {
        "object_id": "822274303",
        "object_type": "product_option",
        "image_path": "https://example.com/images/detailed/0/blue_small_pants.jpg",
        "alt": "Blue Small Pants",
        "image_x": "500",
        "image_y": "500"
      }
    }
  }
}

Campos da resposta

combination_hashstring
O hash identificador único desta combinação de opções.
product_idstring
O ID do produto ao qual esta combinação pertence.
product_codestring
O código de produto/SKU desta combinação específica.
combinationobject
Um mapeamento de IDs de opção para IDs de variante que define esta combinação.
amountstring
A quantidade em estoque disponível desta combinação.
positionnumber
A posição de ordenação desta combinação.
image_pairsobject
Imagens associadas a esta combinação específica.
Dica

As combinações representam configurações específicas das opções do produto (como "Pequeno+Azul"). Cada combinação pode ter o seu próprio nível de estoque, código de produto (SKU) e imagens. O combination_hash é um identificador único gerado a partir do conjunto de valores de opção selecionados.

Nota

No objeto combination, as chaves são IDs de opção e os valores são os IDs das variantes selecionadas para essas opções. Por exemplo, "3": "12" significa que, para a opção de ID 3 (que pode ser "Tamanho"), a variante de ID 12 (que pode ser "Pequeno") está selecionada.

Veja também

  • Listar combinações de opções
  • Atualizar uma combinação de opções
  • Excluir uma combinação de opções
Anterior
Paginação das combinações
Próxima
Detalhes da combinação de opções
Nesta página
  • Exemplo de requisição
  • Resposta
  • Veja também