VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API legada/Referência completa/Opções do produto

GETConsultar uma opção

Retorna os detalhes de uma opção de produto específica pelo seu id.

Retorna as informações detalhadas de uma opção de produto específica, a partir do seu identificador único.

GET/api/options/{option_id}Admin

Consultar uma opção

Se a requisição der certo, você recebe HTTP/1.1 200 OK e uma resposta JSON com os detalhes da opção.

Parâmetros de caminho

option_idintegerobrigatório
O identificador único da opção.

Exemplo de requisição

bash
curl "$BASE_URL/api/options/3" \
  -u "$EMAIL:$API_KEY"
Resposta de sucesso

Se a requisição der certo, você recebe HTTP/1.1 200 OK e uma resposta JSON com os detalhes da opção.

Resposta

200Opção retornada
json
{
  "option_id": "3",
  "product_id": "12",
  "company_id": "1",
  "option_type": "S",
  "option_name": "Size",
  "required": "Y",
  "position": 10,
  "status": "A",
  "variants": [
    {
      "variant_id": "12",
      "option_id": "3",
      "position": 0,
      "modifier": "",
      "modifier_type": "A",
      "variant_name": "Small",
      "point_modifier": "",
      "weight_modifier": "",
      "weight_modifier_type": "",
      "status": "A"
    },
    {
      "variant_id": "13",
      "option_id": "3",
      "position": 1,
      "modifier": "5.00",
      "modifier_type": "A",
      "variant_name": "Medium",
      "point_modifier": "",
      "weight_modifier": "",
      "weight_modifier_type": "",
      "status": "A"
    },
    {
      "variant_id": "14",
      "option_id": "3",
      "position": 2,
      "modifier": "10.00",
      "modifier_type": "A",
      "variant_name": "Large",
      "point_modifier": "",
      "weight_modifier": "",
      "weight_modifier_type": "",
      "status": "A"
    }
  ]
}

Campos da resposta

Campos da opção

CampoTipoDescrição
option_idstringO identificador único da opção
product_idstringO ID do produto ao qual a opção pertence
company_idstringO ID da empresa ou do vendedor
option_typestringO tipo da opção: S (caixa de seleção), R (botão de opção), C (caixa de marcação), I (texto), T (área de texto), F (arquivo), D (data) etc.
option_namestringO nome de exibição da opção
requiredstringIndica se a opção é obrigatória: Y (sim) ou N (não)
positionnumberA posição de ordenação desta opção
statusstringO status da opção: A (ativa) ou D (desativada)
variantsarrayUma lista com as variantes ou valores da opção

Campos da variante

CampoTipoDescrição
variant_idstringO identificador único da variante
option_idstringO ID da opção pai
positionnumberA posição de ordenação desta variante
modifierstringO valor do modificador de preço
modifier_typestringO tipo do modificador de preço: A (absoluto) ou P (percentual)
variant_namestringO nome de exibição da variante
statusstringO status da variante: A (ativa) ou D (desativada)
Dica

As opções de produto permitem que o cliente personalize a compra. A estrutura inclui a própria opção (por exemplo, "Size") e suas variantes ou valores (por exemplo, "Small", "Medium", "Large"). Os modificadores de preço podem ajustar o preço do produto conforme as opções escolhidas.

Veja também

  • Listar opções
  • Detalhes da opção
Anterior
Listar opções do produto
Próxima
Detalhes da opção
Nesta página
  • Exemplo de requisição
  • Resposta
  • Campos da resposta
  • Campos da opção
  • Campos da variante
  • Veja também