Dump de categorias

O que é a árvore de categorias?

A árvore de categorias é uma estrutura na qual o Mercado Livre organiza suas listagens. Cada um dos países tem sua própria árvore de categorias que é diferente das outras. As listagens só podem ser realizadas nas categorias folha da árvore.

Mudanças na árvore de categorias

Às vezes, há mudanças na árvore de categorias, seja porque uma nova categoria é criada, seja porque uma categoria existente é dividida em duas ou mais categorias. Todos os anúncios incluídos na categoria anterior são automaticamente deslocados para a nova.

Por que devo sincronizar a árvore de categorias?

Recomenda-se realizar diariamente um dump de toda a árvore de categorias para o site de um determinado país destinado ao processamento off-line. Assim, é possível estar atualizado com as novas categorias. É muito útil oferecer a seu usuário a chance de fazer um mapeamento de categorias de seu lado para a árvore de categorias do Mercado Livre.

Trabalhar com o dump da árvore de categorias

A API retorna a árvore de categorias no formato JSON dentro de uma resposta codificada com gzip.
Por exemplo, para obter as categorias do Brasil, ele utiliza a seguinte URL:

 curl https://api.mercadolibre.com/sites/MLB/categories/all  > categoriesMLB.gz 

Essa URL contém dois cabeçalhos que podem ser utilizados para verificar quando foi gerado o último dump.

  • X-Content-Created: contém a data da última geração.
  • X-Content-MD5: contém a soma de verificação MD5 da última geração.
 ~$ curl -I  https://api.mercadolibre.com/sites/MLB/categories/all
HTTP/1.1 200 OK
Server: nginx/1.0.4
Date: Tue, 24 Jul 2012 15:14:58 GMT
Content-Type: application/json;charset=UTF-8
Connection: keep-alive
X-MLAPI-Version: 1.9.5
Content-Encoding: gzip
X-Content-Created: 2012-07-24T14:00:59.716Z
X-Content-MD5: 943541196986770119b4af1e66bda2dc

Trabalhar com o dump da árvore de categorias con atributos

Conforme que as categorias tem atributos proprios é precisso fazer a seguente chamada para baixar um arquivo que contém a árvore de categorias com cada um de seus atributos.

Exemplo:

curl https://api.mercadolibre.com/sites/MLA/categories/all?withAttributes=true > mla.gz


Qualifique entre 1 e 5