Este artigo interno explica como validar os atributos obrigatórios de uma categoria do Mercado Livre.
Essa validação pode ser utilizada quando o cliente reporta que alguns atributos estão retornando como obrigatórios no anúncio. Com esse procedimento, é possível consultar diretamente na API do Mercado Livre quais atributos são exigidos para a categoria vinculada ao produto.
Neste artigo:
- Pré-requisitos
- Como funciona a validação de atributos obrigatórios
- Como consultar os atributos obrigatórios
- Boas práticas
- Dúvidas comuns
Pré-requisitos
Antes de iniciar a consulta, tenha em mãos:
- MLB do anúncio analisado;
- Acesso ao Kibana, no índice OUTPUT;
- Acesso ao Postman;
- Authorization do cliente, coletada pela ferramenta de suporte;
- ID da categoria do Mercado Livre, quando já conhecido.
Como funciona a validação de atributos obrigatórios
Para consultar os atributos obrigatórios, primeiro é necessário identificar a categoria do Mercado Livre vinculada ao anúncio.
Essa categoria pode ser localizada no retorno da consulta do item, no campo:
category_idDepois de identificar a categoria, a consulta dos atributos obrigatórios é feita pelo endpoint:
https://api.mercadolibre.com/categories/{CATEGORY_ID}/technical_specs/inputEssa chamada retorna as especificações técnicas da categoria, incluindo os atributos exigidos para cadastro ou atualização do anúncio.
Como consultar os atributos obrigatórios
1. Identificar o MLB do anúncio
Primeiro, identifique o MLB do anúncio que será utilizado na análise.
Neste exemplo, será utilizado o MLB abaixo:
MLB16919229722. Consultar o item no OUTPUT
Acesse o Kibana e, no índice OUTPUT, pesquise pela URL abaixo junto com o MLB do anúncio:
https://api.mercadolibre.com/items/Exemplo de busca:
"https://api.mercadolibre.com/items/" AND "MLB1691922972"
3. Localizar o category_id no responseBody
No responseBody, localize o campo category_id.
Exemplo:
"category_id": "MLB193945"Com essa informação, será possível consultar os atributos obrigatórios da categoria.
4. Montar a consulta no Postman
Abra o Postman e acesse:
Import > Raw textEm seguida, informe o curl abaixo:
curl -X GET \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/categories/$CATEGORY_ID/technical_specs/inputNa URL, substitua $CATEGORY_ID pela categoria coletada no passo anterior.
Exemplo:
https://api.mercadolibre.com/categories/MLB193945/technical_specs/inputNo header Authorization, informe o token coletado na ferramenta de suporte, filtrando pelo cliente analisado.

5. Validar a requisição no Postman
No Postman, confira se a URL e o header de autorização foram preenchidos corretamente.

6. Enviar a consulta
Após preencher os dados, clique em Send.
O Mercado Livre retornará os atributos obrigatórios e demais informações técnicas da categoria.
Exemplo de retorno:

7. Consultar documentação de apoio
Para mais informações sobre atributos do Mercado Livre, consulte:
https://developers.mercadolivre.com.br/pt_br/atributos
Boas práticas
- Confirme o MLB do anúncio antes de iniciar a análise.
- Use o OUTPUT para localizar o retorno da consulta do item.
- Valide o campo
category_idnoresponseBody. - Substitua corretamente o
$CATEGORY_IDno endpoint de especificações técnicas. - Utilize o token de autorização correto, coletado pela ferramenta de suporte para o cliente analisado.
- Use o retorno da API para orientar o cliente sobre quais atributos são obrigatórios para a categoria.
- Consulte a documentação oficial do Mercado Livre quando precisar validar comportamento de atributos.
Dúvidas comuns
Quando devo usar essa validação?
Quando o cliente reportar que alguns atributos estão retornando como obrigatórios no anúncio e for necessário confirmar quais atributos são exigidos para a categoria no Mercado Livre.
Qual é o primeiro passo da análise?
Identificar o MLB do anúncio e consultar o item no OUTPUT.
Como encontro a categoria do anúncio?
No retorno da consulta do item, localize o campo category_id no responseBody.
Qual endpoint consulta os atributos obrigatórios?
O endpoint https://api.mercadolibre.com/categories/{CATEGORY_ID}/technical_specs/input.
Preciso usar Authorization?
Sim. A chamada deve ser feita com Authorization: Bearer $ACCESS_TOKEN.
Onde consigo o token de autorização?
Na ferramenta de suporte, filtrando pelo cliente analisado.
O que devo substituir no curl?
Substitua $CATEGORY_ID pelo ID da categoria coletado no retorno da consulta do item e informe o token no header de autorização.
O que o Mercado Livre retorna nessa consulta?
O Mercado Livre retorna as especificações técnicas da categoria, incluindo atributos obrigatórios e demais regras da categoria.
Qual exemplo de MLB foi usado no procedimento?
O exemplo utilizado foi MLB1691922972.
Qual exemplo de category_id foi demonstrado?
O exemplo demonstrado foi MLB193945.
Comentários
0 comentário
Por favor, entre para comentar.