Pular para o conteúdo principal

Token de Acesso

Para poder começar a trabalhar coma API do Mercado Livre é necessário começar criando o seu token de acesso (access_token).

Passo-a-passo para conseguir o token de acesso​

1. Primeiramente é necessário criar uma conta no Mercado Livre​

Acesse a Página de Cadastro do Mercado Livre e siga o passo a passo deles para criar a sua conta, preenchendo as informações solicitadas por eles.

Com a conta criada prossiga com o guia.

2. Acesse o DevCenter​

  • Acesse o Dev Center que é o site do Mercado Livre onde você poderá criar a sua aplicação.

criando aplicação

  • Preencha as informações básicas:
    • Nome da aplicação
    • Nome curto da aplicação
    • Descrição da aplicação
    • Logo da aplicação

preenchendo informações básicas

  • Configure as informações específicas da aplicação:
    • URL de redirecionamento: url para a qual o Mercado Livre aceitará enviar o código de seção e o token de acesso
    • Escopos: permissões que a aplicação terá sobre sua conta
    • Configuração de Notificações: sempre que houver movimentações na conta advindas da aplicação será enviada uma notificação para a url cadastrada aqui.

preenchendo informações específicas

  • Obtendo os valores de id do aplicativo e chave de acesso

encontrando informações do aplicativo

3. Obtendo o CODE​

  • Após obter o appId (id do aplicativo) e a secret key(chave de acesso) pode ser feita a autenticação, primeiramente envie uma requisição dessa forma:
curl`https://auth.mercadolivre.com.br/authorization?response_type=code&client_id=${appId}&redirect_uri=${REDIRECT_URL}`;

Onde:

  • appId: id do aplicativo
  • REDIRECT_URL: url de redirecionamento cadastrada no DevCenter

O site para o qual o redirecionamento ocorre recebe um código como parâmetro pela url, e precisa ser armazenado.

O Código terá o seguinte formato:

"TG-655a65f83d1952000163536d-1550449927";

4. Obtendo o ACCESS_TOKEN​

  • Com o código é possível enviar a solicitação de autenticação e receber o access_token, com a seguinte requisição POST:
  curl -X POST "https://api.mercadolibre.com/oauth/token" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -H "Accept: application/json" \
    -d `grant_type=authorization_code&client_id=${appId}&client_secret=${secretKey}&code=${code}&redirect_uri=${REDIRECT_URL}`

Onde:

  • appId: id do aplicativo cadastrado no DevCenter
  • secretKey: chave de acesso do aplicativo cadastrado no DevCenter
  • REDIRECT_URL: url de redirecionamento cadastrada no DevCenter

Com isso a resposta será um token de acesso nesse formato:

"APP_USR-3896949906901580-111915-c9026402bc95a91329bb0acbfb68969b-1550449927";

Tokens de Acesso expiram com certa frequência, a cada 24 horas, então toda vez que se passar um dia é necessário solicitar um novo access_token.

5. Utilizando o ACCESS_TOKEN​

Com o token de acesso é possível começar a enviar requisições para a API que modificam a sua conta, como cadastrar, atualizar e remover produtos, configurar outras partes da sua conta, entre outros...

Para enviar uma requisição o access_token deve sempre estar presente e o body deve estar em formato JSON, como no exemplo:

  curl -X PUT -H 'Authorization: Bearer {ACCESS_TOKEN}' -H "Content-Type: application/json" -d
  {
    "plain_text":"Texto da nova descrição  \n"
  }
  https://api.mercadolibre.com/items/{ITEM_ID}/description?api_version=2