Registra tu aplicación

Para registrar una aplicación, debes dirigirte a nuestro Administrador de aplicaciones, seleccionar tu país e iniciar sesión. Una vez iniciada la sesión, podrás pulsar sobre "Crear nueva aplicación" y deberás completar algunos detalles sobre tu aplicación. Luego, obtendrás un Client_Id y Secret_Key, necesarios para autenticarte con nuestra API.

Contenidos

→Datos de la aplicación
→Información básica de la aplicación
→Autenticación y seguridad
    ↳Consideraciones sobre scopes
      ↳Aplicaciones online de lectura/escritura
      ↳Aplicaciones offline de lectura/escritura
→Configuraciones de notificaciones
→Accede a tu información de usuario con nuestros SDK
→Realiza pruebas


Datos de la aplicación

Existen tres grupos de información en este formulario: Información Básica de la aplicación, Autenticación y Seguridad y Configuraciones de Notificaciones. https


Información básica de la aplicación

app_id: Es tu client_id. Se debe utilizar para recuperar un access token.

secret_key: También se utiliza para recuperar un access token. No compartas este secreto con nadie. name: Nombre de tu aplicación. Debe ser único.

short_name: Nombre que Mercado Libre utiliza para generar el URL de tu aplicación.

description: Esta descripción (hasta 150 caracteres) se mostrará cuando la aplicación solicite una autorización.


Autenticación y seguridad

Callback URL: URI de redireccionamiento. URL para devolver usuarios a tu aplicación una vez que conceden acceso.

Dominios: Authorized Javascript Origins [Orígenes de Javascript Autorizados]. Lista de nombres de dominio totalmente calificados, separados por coma, de todas las páginas que utilizarán la autenticación del client side. Solo sería necesaria si se utiliza la API de Javascript. No incluye protocolo, puerto ni “localhost”. Estos dos atributos se explican en mayor detalle en la guía de Autenticación y Autorización.

Scopes

  • Lectura: Permite el uso de métodos API GET HTTP.
  • Escritura: Permite el uso de métodos API PUT, POST y DELETE HTTP.
  • Acceso Offline: Permite realizar una solicitud del server side y refresh token.
Notas:
- Para crear una aplicación dentro del Application Manager es requisito obligatorio utilizar el protocolo HTTPS en su URI de redireccionamiento ya que de esta forma se asegura que el mensaje se envíe encriptado y sólo las personas autorizadas puedan leerlo.
- Si aún sigues utilizando HTTP y quieren realizar cambios deberás configurar la nueva URL con HTTPS.

Consideraciones sobre scopes

Existen varios tipos de aplicaciones. No obstante, las dividiremos en tres grupos para explicar los scopes requeridos. aplicaciones de solo lectura: aplicación que permite a un usuario anónimo o autenticado acceder a información personalizada de MELI. En este caso, un usuario anónimo podría buscar artículos, leer descripciones, etc. y un usuario autenticado puede ver la información personal. Si no realizas ninguna modificación a los datos de MELI (ninguna actualización de la información de usuario, publicación de artículos ni compra de artículos), todo lo que necesitas es un scope de lectura. Recuerda que cualquier intento por modificar datos a través de las API de Meli arrojaría error.


Aplicaciones online de lectura/escritura

Este tipo de aplicación permite que un usuario anónimo realice ciertas operaciones de solo lectura en MELI, así como también permite a un usuario autenticado modificar datos, publicar nuevos artículos (vender), publicar pedidos (comprar), etc. En este caso, la aplicación requiere un scope de escritura para que el usuario pueda otorgar permisos de escritura y la aplicación actúe en su nombre. La aplicación podrá modificar datos en nombre del usuario mientras el access token tenga validez. Una vez expirado, el usuario debe renovar el token para volver a tener acceso.


Aplicaciones offline de lectura/escritura

Si tu aplicación debe actuar en nombre del usuario aún cuando este último está offline, requerirá permiso de acceso offline por parte del usuario. Al solicitar este scope, una vez aceptada por el usuario, la aplicación tendrá tanto el access token para actuar en nombre del usuario como un refresh token para obtener un nuevo access token válido cuando expire el anterior.



Configuraciones de notificaciones

Callback URL de Notificaciones: configura el URL público del dominio donde deseas recibir las notificaciones para los diferentes temas.

Topics: lista de temas a los que deseas suscribirte. Existen seis temas posibles: orders, items, questions, created_orders y payments.


Accede a tu información de usuario con nuestros SDK

Nuestros SDK te permitirán acceder a tu perfil de usuario utilizando tu propia aplicación.

Realiza pruebas

Inicializa la API con tu client_id como lo vemos:

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) }
  );
});

Siguiente: Autenticación y Autorización.