Gestão de aplicações

Consulte as informações essenciais para trabalhar com nossas APIs
circulos azuis em degrade

Você pode usar esta documentação para as seguintes unidades de negócio:

Última atualização em 15/03/2023

Gestiona tus aplicaciones

Detalles de las aplicaciones

Para acceder a los detalles completos sobre una de tus aplicaciones, simplemente incluye el app_id en la llamada a la API.


Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/applications/$APP_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/applications/12345

Respuesta:

{
  "id": 213123928883922,
  "site_id": "MLB",
  "thumbnail": null,
  "url": "http://apps.mercadolivre.com.br/polipartes",
  "sandbox_mode": true,
  "project_id":null,
  "active": true,
  "max_requests_per_hour": 18000,
  "certification_status": "not_certified"
}

Datos privados de tu aplicación

Cada que vez que quieras conocer más detalles de los datos de tu aplicación, deberás hacerlo utilizando el Access Token del usuario con el que se creó.


Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/applications/$APP_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/applications/12345

Aplicaciones autorizadas por usuario

Para acceder a todas las aplicaciones autorizadas por un usuario, simplemente haz un GET con el user_id y el access token.


Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/applications

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/26317316/applications

La respuesta será un conjunto de aplicaciones con el siguiente formato:

[
  - {
  "user_id": "26317316",
  "app_id": "13795",
  "date_created": "2012-12-20T15:38:27.000-04:00",
  "scopes": - [
    "read",
    "write",
  ],
   },
]

Usuarios que le dieron permisos a tu aplicación

Para acceder al listado de usuarios que le dieron permisos a tu app, simplemente realiza el siguiente GET:


Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/applications/$APP_ID/grants

Respuesta:

{
    "paging": {
        "total": 1,
        "limit": 50,
        "offset": 0
    },
    "grants": [
        {
            "user_id": {user_id},
            "app_id": {app_id},
            "date_created": "2012-05-19T01:00:54.000-04:00",
            "scopes": [
                "read",
                "offline_access",
                "write"
            ]
        }
    ]
}

Descripción de los campos

  • user_id: identificador del usuario.
  • app_id: identificador de la aplicación.
  • date_created: fecha en que fue creada la autorización.
  • scopes: permisos otorgados a la aplicación: lectura, escritura y offline_access.

Revoca la autorización del usuario

Para eliminar la autorización de un usuario a tu aplicación, debes especificar el app_id, user_id y su access token. Simplemente, haz un DELETE como se muestra en el ejemplo a continuación:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/applications/$APP_ID

La respuesta debería ser:

{
    "user_id":"{user_id}",
    "app_id":"{app_id}",
    "msg":"Autorización eliminada"
}