Gestiona tus aplicaciones

Contenidos

→Detalles de las aplicaciones
→Datos privados de tu aplicación
→Aplicaciones autorizadas por usuario
→Usuarios que le dieron permisos a tu aplicación
→Descripción de los campos
→Revoca la autorización del usuario


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 https://api.mercadolibre.com/applications/$APP_ID

Ejemplo:

curl -X GET https://api.mercadolibre.com/applications/12345

Respuesta:

{
  "id": 213123928883922,
  "site_id": "MLB",
  "name": "ML Test",
  "description": "ML Test APP",
  "thumbnail": null,
  "owner_id": 999999,
  "catalog_product_id": null,
  "item_id": null,
  "price": null,
  "currency_id": null,
  "need_authorization": true,
  "short_name": "polipartes",
  "url": "http://apps.mercadolivre.com.br/polipartes",
  "callback_url": "http://www.vtexml.com.br/",
  "sandbox_mode": true,
  "is_public": true,
  "project_id":null,
  "active": true,
  "max_requests_per_hour": 18000,
  "scopes": [],
  "domains": [
  ],
  "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 https://api.mercadolibre.com/applications/$APP_ID?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/applications/12345?access_token=$ACCESS_TOKEN

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 https://api.mercadolibre.com/users/$USER_ID/applications?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/users/26317316/applications?access_token=$ACCESS_TOKEN

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 https://api.mercadolibre.com/applications/$APP_ID/grants?access_token=$ACCESS_TOKEN

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 https://api.mercadolibre.com/users/$USER_ID/applications/$APP_ID?access_token=$ACCESS_TOKEN

La respuesta debería ser:

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

Forma parte de nuestra comunidad