Gestión de aplicaciones
Consulta la información esencial para trabajar con nuestras APIsDocumentación
Puedes usar esta documentación para las siguientes unidades de negocio:
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"
}