Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.Documentação do
Novidades de vendedores
Consultar novedades
Parâmetros opcionais
limit: limite máximo de comunicações a serem recebidas
offset: se o total for maior que o limite, o offset é usado para paginação
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/communications/notices?limit=$LIMIT&offset=$OFFSET
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/communications/notices?limit=20&offset=0
Resposta:
{
"paging": {
"total": 2,
"offset": 0,
"limit": 10
},
"results": [
{
"actions": [
{
"text": "Mas información",
"link": "https://developers.mercadolibre.com.ar/es_ar/conoce-las-novedades-que-reciben-los-vendedores"
},
{
"text": "Dar feedback",
"link": "https://www.mercadolibre.com.ar"
}
],
"id": "3691",
"label": "Bienvenidos integradores a la central de novedades! prueba 2",
"description": "Estamos disponibilizando la información de la CDN a todos los integradores desde el mes de junio. Preparate para estar mas informado que nunca de las ultimas novedades de MeLi.
\n",
"highlighted": true,
"from_date": "2021-07-12T15:00:00.000Z",
"tags": [
{
"tag": "BLACK_FRIDAY",
"type": "EVENTS"
},
{
"tag": "BILLING",
"type": "BILLING"
},
{
"tag": "SHIPPING_GENERIC",
"type": "SHIPPING"
}
]
},
{
"actions": [
{
"text": "Mas información",
"link": "https://developers.mercadolibre.com.ar/es_ar/conoce-las-novedades-que-reciben-los-vendedores"
},
{
"text": "Dar feedback",
"link": "https://www.mercadolibre.com.ar"
}
],
"id": "3446",
"label": "Bienvenidos integradores a la central de novedades!",
"description": "Estamos disponibilizando la información de la CDN a todos los integradores desde el mes de junio. Preparate para estar mas informado que nunca de las ultimas novedades de MeLi.
\n",
"highlighted": true,
"from_date": "2021-07-12T15:00:00.000Z",
"tags": [
{
"tag": "COVID",
"type": "EVENTS"
},
{
"tag": "SHIPPING_GENERIC",
"type": "SHIPPING"
}
]
}
]
}
Campos da resposta
paging: formato de paginação dos resultados.
- total: total de resultados encontrados.
- offset: índice do resultado a partir do qual deseja obter. Por exemplo: com 100 novidades en total, utilizando um limit = 20. Se você quiser ver uma segunda página, deve enviar offset = 21 e se mostrará de 21 a 40.
- limit: número máximo de resultados a serem exibidos em uma página
results: listagem das novidades.
- actions(opcional): listagem com as ações.
text: texto da ação.
link: link da ação.
id: identificação da comunicação.
label: título da comunicação.
description: descrição da comunicação.
highlighted: indica se a novidade está em destaque no Mercado Libre ou não.
from_date: data no formato ISO, indica a criação da novidade.
tags: com as siguientes tag identifica os tipos de novidades. Você também pode agrupá-los de acordo com Atenção, Envios, Eventos, Faturamento, Países e Publicações.
Tag | Referência |
---|---|
METRICS | Métricas |
CANCELLATIONS | Cancelamentos |
RETURNS | Devoluções |
CLAIMS | Reclamações |
REPUTATION | Reputação |
Tag | Referência |
---|---|
SHIPPING_GENERIC | Envios |
SHIPPING | Mercado Envios |
SHIPPING_XD | Mercado Envios coleta |
FLEX | Flex |
FULL | Full |
SHIPPING_CARRIER | Mercado Envios Partnered Carrier |
Tag | Referência |
---|---|
CHRISTMAS | Natal |
BLACK_FRIDAY | Black Friday |
HOT_SALE | Hot Sale |
CYBER_MONDAY | Cyber Monday |
COVID | COVID-19 |
Tag | Referência |
---|---|
COST | Custos |
BILLING | Faturamento |
TRANSMITTER | Emisor de NF-e |
Tag | Referência |
---|---|
MCO | Colômbia |
MLC_FULFILLMENT | Chile - Full |
MLC_REMOTE | Chile |
MLB | Brasil |
MLM_REMOTE | México |
MLM_FULFILLMENT | México - Full |
Tag | Referência |
---|---|
PUBLICATIONS | Publicações |
PROMOTIONS_CENTRAL | Central de promoções |
CATALOG | Catálogo |