Application manager

Contents

→Applications details
→Private data of your application
→Applications authorized by user
→Users that granted permissions to your application
→Fields description
→Revoke user authorization


Applications details

To access full details about one of your applications, simply include the app_id in the API request.


Request:

curl -X GET http://api.mercadolibre.com/applications/$APP_ID

Example:

curl -X GET http://api.mercadolibre.com/applications/6098792155457031

Response:

{
    "id": 6098792155457031,
    "site_id": "CBT",
    "name": "Test application to Global Selling operation",
    "description": "Test application ",
    "thumbnail": null,
    "catalog_product_id": null,
    "item_id": null,
    "price": null,
    "currency_id": null,
    "short_name": "TestAppGsInt",
    "url": "http://globalselling.mercadolibre.com/devcenter/testappgsint",
    "callback_url": "https://test.com",
    "sandbox_mode": true,
    "project_id": null,
    "active": true,
    "max_requests_per_hour": 18000,
    "scopes": [
        "offline_access",
        "read",
        "write"
    ],
    "domains": [],
    "certification_status": "not_certified"
}

Private data of your application

Whenever you want to know more details of your application data, you must do so using the Access Token of the user with whom it was created.


Request:

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

Example:

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

Applications authorized by user

To access all the applications authorized by a user, just send a GET request as a user_id and access token.


Request:

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

Example:

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

The response would be an array of applications with the following format:

[
    {
        "user_id": 481241763,
        "app_id": 7982740196824807,
        "date_created": "2019-10-18T16:30:44.000-04:00",
        "scopes": [
            "offline_access",
            "read",
            "write"
        ]
    },
    {
        "user_id": 481241763,
        "app_id": 1503799861804470,
        "date_created": "2020-02-05T13:00:48.000-04:00",
        "scopes": [
            "offline_access",
            "read",
            "write"
        ]
    }
]

Users that granted permissions to your application

To access the list of users that granted your app permissions, make the following GET:


Request:

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

Example:

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

Response:

{
  "grants": [
    {
      "user_id": 481241763,
      "app_id": 1503799861804470,
      "date_created": "2020-02-05T13:00:48.000-04:00",
      "scopes": [
        "offline_access",
        "read",
        "write"
      ]
    }
  ],
  "paging": {
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

Fields description

  • user_id: The user identifier.
  • app_id: The application identifier.
  • date_created: Date when the authorization was created
  • scopes: Permissions given to the application: read, write and offline_access.

Revoke user authorization

To remove any application you must specify the application id, the user id, and the access token. Just doing a DELETE request using this query:

curl -X DELETE https://api.mercadolibre.com/users/$USER_ID/applications/$APP_ID?access_token=$ACCESS_TOKEN

The response should be:

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

Next: Guide for products.