Pular para o conteúdo principal

Atributos

Cada categoria possui um conjunto de atributos específicos, alguns são obrigatórios e outros são opcionais, para você verificar quais são esses atributos será necessário conhecer o id da categoria e fazer uma requisição dessa forma:

  curl https://api.mercadolibre.com/categories/{CATEGORY_ID}/attributes

Exemplo:

  curl https://api.mercadolibre.com/categories/MLB5672/attributes

Resposta:

[
{
"id": "BRAND",
"name": "Marca",
"tags": {
"catalog_required": true,
"required": true,
"catalog_listing_required": true
},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Outros",
"hint": "Informe a marca verdadeira do produto ou 'Genérica' se não tiver marca."
},
{
"id": "PACKAGE_HEIGHT",
"name": "Altura da embalagem",
"tags": {
"hidden": true,
"read_only": true,
"variation_attribute": true
},
"hierarchy": "FAMILY",
"relevance": 1,
"value_type": "number_unit",
"value_max_length": 255,
"allowed_units": [
{
"id": "mm",
"name": "mm"
},
{
"id": "cm",
"name": "cm"
},
{
"id": "m",
"name": "m"
},
{
"id": """",
"name": """"
},
{
"id": "ft",
"name": "ft"
}
],
"default_unit": "cm",
"attribute_group_id": "OTHERS",
"attribute_group_name": "Outros"
},
{
demais atributos...
}
]

Parâmetros dos atributos

Perceba que os atributos possuem parâmetros que são obrigatórios, e iguais para todos, e opcionais que alguns possuem e outros não.

  • Obrigatórios:
  {
"id": "ID_DO_ATRIBUTO",
"name": "NOME_DO_ATRIBUTO",
"tags": "TAGS_DO_ATRIBUTO" podem variar,
"hierarchy": "PRIMARY_KEY_DO_PAI",
"relevance": 1,
"value_type": "TYPO_DO_VALOR_DO_ATRIBUTO",
"value_max_length": "VALOR_MÁXIMO_DO_ATRIBUTO",
}

O parâmetro TAGS possui diversos valores específicos, mas uma tag muito importante é a required que vai receber um valor boleano que define se é um atributo obrigatório na categoria específica.