Registre o seu aplicativo

Para registrar um aplicativo, você deve dirigir-se ao nosso Administrador de Aplicativos, escolher o seu país e iniciar sessão. Logo de iniciar sessão, você poderá clicar no botão “Criar Novo Aplicativo” e deverá preencher alguns detalhes sobre o seu aplicativo. Após isso você vai obter um Client_Id e Secret_Key, necessários para autenticação com nossa API.

Conteúdos

→Dados do aplicativo
→Informações básicas do aplicativo
→Autenticação e segurança
    ↳Escopos
      ↳Considerações sobre os escopos
      ↳Aplicativos on-line de leitura/gravação
      ↳Aplicativos off-line de leitura/gravação
→Configurações das notificações
→Acesse a sua informação de usuário com nossos SDK


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

app id: é seu client_id. Ele deve ser usado para recuperar um token de acesso.

secret key: ela também deve ser usada para recuperar um token de acesso. Não compartilhe sua Senha com ninguém.name: nome de seu aplicativo. Ele deve ser único.

short name: é o nome que o MErcado Livre utiliza para gerar a URL de seu aplicativo.

description: 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.


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.
Notas:
- Para criar um aplicativo no Application Manager é obrigatório usar o protocolo HTTPS no URI de redirecionamento, pois isso garante que a mensagem seja enviada criptografada e que somente pessoas autorizadas possam lê-la.
- Se você ainda estiver usando HTTP e quiser fazer alterações, deverá configurar o novo URL com HTTPS.

Consideraciones sobre scopes

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.


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.

Siguiente: Autenticación y Autorización.