Moderações

Foi desenvolvida uma API que permite ao integrador consultar os elementos que estão com alguma moderação, ou seja, que não passou em algum dos filtros da plataforma. Por exemplo, anúncios que por algum motivo ficaram pendentes para revisão por motivo de preço, descrição, etc., ou questões que tiveram algum conteúdo que não passou no filtro. Dessa forma o integrador poderá ter acesso a algumas situações que só eram exibidas na plataforma para o vendedor.

Conteúdo

Consultar moderações

Através do GET é possível consultar os elementos que estão com alguma moderação.

GET https://api.mercadolibre.com/moderations/infractions/{user_id}?access_token={access_token}

Exemplo

GET https://api.mercadolibre.com/moderations/infractions/305860144?access_token=ACCESS_TOKEN

Aclarações: Tenha em conta que na resposta não obterá os itens que foram dado baixa por duplicados.

Consultar moderações com filtro

É possível realizar a mesma consulta com alguns filtros, como: ano e limite de registros a serem retornados na API.

GET https://api.mercadolibre.com/moderations/infractions/{user_id}?year_month=201711&limit=50&offset=0&access_token={access_token} 

Exemplo

GET https://api.mercadolibre.com/moderations/infractions/305860144?year_month=201711&limit=50&offset=0&access_token=ACCESS_TOKEN

Resposta

{
    "message": "1 items with infractions since December 2017",
    "seller": {
        "id": 305860144,
        "nickname": "TESTDD9J81ZY"
    },
    "paging": {
        "limit": 20,
        "offset": 0,
        "total": 1
    },
    "results": [
        {
            "element_id": "MLB997546581",
            "element_type": "ITM",
            "infraction_date": "2018-03-21T09:59:30.480-04:00",
            "type": "infraction",
            "reason": "Mal categorizado - Categoría - Titulo",
            "current_status": "under_review",
            "sub_status": [
                "waiting_for_patch"
            ]
        }
    ]
}

Considerações

limit Límite para o paginado (Default = 20, <= 50)

offset Offset para o paginado (Default = 0, <=50)

year_month Ano e mês desde quando quer obter as infrações (Exemplo: 201711 (Año y Mes))

Relação dos status

  • Tipo de elemento (results.element_type)
  • – ITM (item) – Significa que o elemento é um anuncio
    – QUE (questão) – Significa que o elemento pode ser uma pergunta ou resposta no anúncio.

  • Tipo de infracción (results.type)
  • – Neste momento só será retornada o tipo “infraction”.

  • Estado do elemento atualmente (results.current_status)
  • – Os possíveis status que podem ser retornados são: under_review, paused, active.

  • Listado de sub estados do elemento atualmente (results.sub_status)
  • – O substatus pode retornar vazio e também pode retornar:

  • Status “under_review”
  • – waiting_for_patch, suspended, held, banned, pending_documentation, forbidden, suspended_for_prevention.

  • Status “paused”
  • – freezes, suspended

    Qualifique entre 1 e 5