Recursos Cross
Confira os principais recursos das nossas APIsDocumentação do
Você pode usar esta documentação para as seguintes unidades de negócio:
Qualidade de fotografia de moda
Requisitos para imagens
Você deve usar imagens de qualidade para ter uma melhor posicionamento nas listagens de busca conforme o produto:
- Vestidos e macacões
- Roupas de bebês
- Roupa íntima e de praia
- Calçados
- Tops
- Acessórios
- Packs
- Partes de baixo
Saiba mais recomendações de Moda no Central de Vendedores para MLA, MLM, MLB e MLC
Buscar publicações por status de certificação
Para identificar se a publicação passou os processos de certificação de qualidade deverá usar o recurso /picture-certifier/integrator/items..
Este recurso permitirá realizar buscas por status, podendo identificar se as publicações de um vendedor estão não certificadas (NOT_CERTIFIED), ou certificadas (CERTIFIED) ou itens que se encontram em processo de revisão (UNDER_REVIEW).
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items?sellerId=$SELLER_ID&categoryId=$CATEGORY_ID&status=$STATUS&offset=0&limit=500
Resposta de itens não certificados (NOT_CERTIFIED):
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items?sellerId=12345&categoryId=MMLB188065LB108807&status=NOT_CERTIFIED&offset=0&limit=500
Resposta:
{
"seller_id": 819780659,
"category_id": "MLB188065",
"items": [
"MLB2677667064",
"MLB2677648896"
],
"paging": {
"limit": 500,
"offset": 0,
"total": 2
},
"item_status": "NOT_CERTIFIED"
}
Exemplo para filtrar publicações certificadas: (CERTIFIED):
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items?sellerId=12345&categoryId=MLB108807&status=CERTIFIED&offset=0&limit=500
Resposta:
{
"seller_id": 819780659,
"category_id": "MLB108807",
"items": [
"MLB2677667080",
"MLB2677648827"
],
"paging": {
"limit": 500,
"offset": 0,
"total": 2
},
"item_status": "CERTIFIED"
}
Exemplo para filtrar publicações que estão em processo de revisão (UNDER_REVIEW):
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items?sellerId=12345&status=UNDER_REVIEW&offset=0&limit=500
Resposta:
{
"seller_id": 12345,
"items": [
"MLM1438692500",
"MLM1438742336",
"MLM1438692778",
"MLM1438724478"
],
"paging": {
"limit": 500,
"offset": 0,
"total": 4
},
"item_status": "UNDER_REVIEW"
}
Descrição dos campos
- seller_id: id do vendedor.
- category_id: id da categoria consultada.
- Items: id das publicações que cumprem os critérios de busca (STATUS).
- item_status: estado das publicações com relação à validação de qualidade (CERTIFIED, NOT CERTIFIED, UNDER_REVIEW).
Como melhorar a imagem do item
Uma vez identificados os anúncios com imagens em estado NOT CERTIFIED poderá consultar as condições para conseguir que o item tenha imagens de qualidade certificadas.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/picture-certifier/integrator/items/$ITEM_ID/status?locale=$LOCALE&sellerId=$SELLER_ID
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items/MLB2677667064/status?locale=pt_BR&sellerId=1234
Resposta de anúncio que não está certificado:
{
"status": "NOT_CERTIFIED",
"reason": "Seu anúncio de moda não está bem apresentado
A primeira foto do seu anúncio deve ser com um modelo, manequim invisível ou somente do produto, conforme os requisitos do seu tipo de roupa.
Como tirar fotos para moda,
"conditions": [
{
"id": "presentation_badly_pres",
"message": "Você deve usar um modelo, manequim invisível ou mostrar o produto sozinho, de acordo com o tipo de peça.",
"unique_intro": "Seu anúncio de moda não está bem apresentado",
"unique_message": "A primeira foto do seu anúncio deve ser com um modelo, manequim invisível ou somente do produto, conforme os requisitos do seu tipo de roupa."
}
]
}
Descrição de campos
- status: estado da publicação com relação à validação do track educativo. (CERTIFIED, NOT_ CERTIFIED, UNDER_REVIEW).
- reason: caso o status seja NOT_ CERTIFIED será apresentado o motivo pelo qual a publicação não cumpre a validação de qualidade e as ações que o vendedor deve realizar sobre a imagem para que o status mude.
- conditions: refere-se ao detalhe das condições pelas quais a publicação não foi certificada, para o exemplo: correct_background_acc quer dizer que a imagem não tem um fundo correto e illumination_acc não conta com uma iluminação adequada.