Registre o seu aplicativo

Para registrar um aplicativo, você deve acessar nosso Gerenciador de Aplicações, selecionar seu país e fazer login.
O aplicativo só funcionará no país onde o usuário estiver registrado, portanto, você precisará de um nome de usuário e aplicativo para cada país onde quiser trabalhar.
Depois de ter feito login, você deverá preencher alguns detalhes sobre seu aplicativo para depois obter um ID de Cliente e uma Senha, necessários para fazer a autenticação em nossa API.

Assuntos

Dados do aplicativo

Nesse formulário existem três grupos de informações: informações básicas do aplicativo, autenticação e segurança e configurações das notificações.
https


Informações básicas do aplicativo

  • ID: é seu client_id. Ele deve ser usado para recuperar um token de acesso.
  • Senha: ela também deve ser usada para recuperar um token de acesso. Não compartilhe sua Senha com ninguém.
  • Nome: nome de seu aplicativo. Ele deve ser único.
  • Nome curto: é o nome que o MELI utiliza para gerar a URL de seu aplicativo.
  • Descrição: a descrição (de até 150 caracteres) será mostrada quando o aplicativo solicitar autorização.

Autenticação e segurança

  • URL de retorno: URL de redirecionamento. URL para enviar usuários de volta para a seu aplicativo assim que for concedido o acesso.
  • Domínios: Authorized Javascript Origins [Origens de Javascript Autorizadas]. Lista de nomes de domínio totalmente autorizados, separados por vírgula, de todas as páginas que utilizarão a autenticação no client. Ela só será necessária se for usada a API de Javascript. Não inclui protocolo, porta nem “localhost”.

Esses dois atributos são explicados com mais detalhes no guia de Autenticação e Autorização.
Notas:

  • Para criar um aplicativo dentro do Application Manager é requisito obrigatório utilizar o protocolo HTTPS em sua URI de encaminhamento pois, dessa forma, garante-se que a mensagem seja criptografada e somente enviada para as pessoas autorizadas para sua leitura.
  • Se você ainda continuar utilizando HTTP e quiser aplicar mudanças, deverá configurar a nova URL com HTTPS.

Escopos

  • Leitura: permite o uso do método HTTP: GET.
  • Gravação: permite o uso de métodos HTTP: PUT, POST e DELETE.
  • Acesso off-line: permite realizar uma solicitação do servidor e do token de atualização.

Considerações sobre os escopos
Existem diversos tipos de aplicativos. No entanto, vamos dividi-los em três grupos para explicar quais são os escopos necessários.
Aplicativos somente leitura: aplicativo que permite a um usuário anônimo ou autenticado acessar informações personalizadas do MELI. Nesse caso, um usuário anônimo pode buscar produtos, ler descrições etc., e um usuário autenticado pode visualizar as informações pessoais. Caso você não faça nenhuma alteração nos dados do MELI (nenhuma atualização das informações de usuário, publicação de produtos ou compra de produtos), tudo que você precisa é de um escopo de leitura. Lembre-se de que qualquer tentativa de alteração de dados através das API do MELI gera erro.

  • Aplicativos on-line de leitura/gravação: esse tipo de aplicativo permite a um usuário anônimo realizar certas operações somente leitura no MELI, assim como a um usuário autenticado alterar dados, publicar novos produtos (vender), publicar pedidos (comprar) etc. Nesse caso, o aplicativo requer um alcance de gravação para que o usuário possa conceder permissões de gravação e o aplicativo aja em seu nome. O aplicativo poderá alterar dados em nome do usuário enquanto o token de acesso for válido. Uma vez expirado, o usuário deverá renovar o token para ter acesso novamente.
  • Aplicativos off-line de leitura/gravação: se seu aplicativo precisar agir em nome do usuário, mesmo estando off-line, ele exigirá permissão de acesso off-line por parte do usuário. Ao solicitar esse escopo, uma vez aceito pelo usuário, o aplicativo terá tanto o token de acesso para agir em nome do usuário quanto um token de atualização para obter um novo token de acesso válido quando o anterior expirar.

Configurações das notificações

  • URL de retorno de notificações: configure a URL pública do domínio onde você quer receber notificações sobre os diversos tópicos.
  • Tópicos: listagem de assuntos sobre os quais quer receber informações. Existem seis tópicos possíveis: orders, items, questions, payments, created_orders e pictures.

Considerações

Ao trabalhar com usuários de teste, você deverá levar em conta as seguintes considerações:

  • Com sua conta do Mercado Livre, você pode criar até 10 usuários de teste.
  • Os usuários de teste não ficarão ativos durante muito tempo, mas depois que perderem a validade, você poderá criar novos.
  • Os anúncios deverão ser intitulados “Item de Teste – NÃO OFERECER”.
  • Se for possível, faça a publicação na categoria “Outros”.
  • Nunca faça uma publicação “gold” nem “gold_premium” para que ela não apareça na página inicial.
  • Os usuários de teste só podem operar com produtos de teste: eles só podem comprar, vender e fazer perguntas sobre produtos de teste.
  • Os usuários de teste que não tiverem atividade (compras, perguntas, publicações etc.) durante um prazo de 60 dias, serão excluídos imediatamente.
  • Esses produtos são excluídos periodicamente.

Acesse a sua informação de usuário com nossos SDK

Nossos SDK lhe permitirão acessar a seu perfil de usuário utilizando seu próprio aplicativo.

Realização de testes

Inicie a API com seu client_id como se indica:

MELI.init({client_id: 6092});
Así de fácil. Luego, la siguiente línea de código mostrará el primer nombre que registraste en MercadoLibre:
MELI.login(function() {
  MELI.get(
	"/users/me",{},
  	function(data) { alert("Hello "+data[2].first_name) }
  );
});





Próximo:
Autorização.

Please rate this