Moderaciones

Hemos habilitado un nuevo recurso que te permitirá consultar las publicaciones afectadas por algún tipo de moderación, es decir que no pasaron alguno de los filtros de la plataforma. Por ejemplo, publicaciones que, por algún motivo, quedaron pendientes de revisión debido al precio, descripción, etc., o preguntas que incluyan algún contenido que no supere el filtro. De esta forma, el integrador podrá acceder a algunas situaciones que sólo serán visualizadas en la plataforma por el vendedor.

Contenidos

→Consultar moderaciones
→Consultar moderaciones con filtro
→Consideraciones
→Listado de estados


Consultar moderaciones

A través del GET se pueden consultar los elementos afectados por algún tipo de moderación.
Llamada:

curl -X GET https://api.mercadolibre.com/moderations/infractions/$USER_ID?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/moderations/infractions/305860144?access_token=$ACCESS_TOKEN
Nota:
Ten en cuenta que en la respuesta no se verán los ítems dados de baja por duplicados y solo aparecen los ítems en el cual los estados pueden ser finales (forbidden) o temporales (waiting_for_patch, held, pending_documentation). Si quieres consultar si un usuario está suspendido puedes hacerlo a través de users (https://api.mercadolibre.com/users/$USER_ID) y chequear el campo status => list => allow. En caso que sea false ese campo, significa que está suspendido.
Importante:
En caso de que el usuario esté suspendido, deberá consultar la configuración de su cuenta en el portal de Ayuda.


Consultar moderaciones con filtro

Se puede realizar la misma consulta con algunos filtros, tales como: año y límite de registros que serán exhibidos por la API.


Llamada:

curl -X GET https://api.mercadolibre.com/moderations/infractions/$USER_ID?year_month=201711&limit=50&offset=0&access_token=$ACCESS_TOKEN

Ejemplo:

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

Respuesta:

{
    "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"
            ]
        }
    ]
}


Consideraciones

limit: límite para el paginado (Default = 20, <= 50)
offset: offset para el paginado (Default = 0, <=50)
year_month: año y mes desde cuando se quiere obtener infracciones (Ejemplo: 201711 (Año y Mes)


Listado de estados

  • element_type: tipo de elemento

- ITM (item): significa que el elemento es un anuncio.
-QUE (pregunta/respuesta): el elemento puede ser una pregunta o respuesta en el anuncio.

  • type: tipo de infracción.

- En este momento sólo se mostrará el tipo "infraction".

  • current_status: estado del elemento actualmente.

- Los posibles estados que pueden mostrarse son: under_review, paused, active.

  • sub_status: listado de sub estados del elemento actualmente. El subestado puede mostrarse vacío y también puede exhibirse.

-Current status under_review: waiting_for_patch, suspended, held, banned, pending_documentation, forbidden, suspended_for_prevention.

- Current status paused: freezes, suspended.