Gerencie seu aplicativo

Conteúdos

→Detalhes dos aplicativos
→Dados privados de sua aplicação
→Aplicações autorizadas por usuário
→Usuários que outorgaram licenças a seu aplicativo
→Descrição de campos
→Revogação da autorização do usuário


Detalhes dos aplicativos

Para acessar todos os detalhes de um de seus aplicativos, basta incluir o app_id na chamada à API.


Chamada:

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

Exemplo:

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

Resposta:

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

Dados privados de sua aplicação

Sempre que você quiser saber mais detalhes dos dados de seu aplicativo, faça isso usando o token de acesso do usuário com quem ele foi criado.


Chamada:

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

Exemplo:

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

Aplicações autorizadas por usuário

Para acessar todos os aplicativos autorizados por um usuário, basta enviar uma solicitação GET com o user_id e o token de acesso.


Chamada:

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

Exemplo:

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

A resposta será um conjunto de aplicativos no seguinte formato:

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

Usuários que outorgaram licenças a seu aplicativo

Para acessar a lista de usuários que outorgaram licenças a seu aplicativo, simplesmente realize o GET a seguir:


Exemplo:

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

Resposta:

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

Descrição de campos

  • user_id: identificador do usuário.
  • app_id: identificador do aplicativo.
  • date_created: data em que a autorização foi criada.
  • scopes: permissões concedidas ao aplicativo: leitura, gravação e offline_access.

Revogação da autorização do usuário

Para eliminar qualquer aplicativo, é preciso especificar seu ID, o ID do usuário e o token de acesso. Basta enviar uma solicitação DELETE utilizando a consulta abaixo:

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

A resposta deve ser:

{
    "user_id":"{user_id}",
    "app_id":"{app_id}",
    "msg":"Autorización eliminada"
}
ou registre-se para receber as últimas notícias sobre nossa API