Crear una aplicación

Crear una aplicación

Resumen

La aplicación obtiene las credenciales que le permiten identificarse al consumir las APIs. Cada desarrollador registrado en el portal puede crear sus aplicaciones, ver y renovar sus llaves, y restringir desde qué dominios o IPs se usan. En este video ve el recorrido completo: crear la aplicación, ver su Auth Key y renovar las llaves.

Antes de comenzar

  • Para crear una aplicación debe estar registrado y autenticado en el portal para desarrolladores.
  • Las aplicaciones se administran en Mis aplicaciones, desde el menú de su usuario.

Crear una aplicación

Datos de la aplicación

En Mis aplicaciones, haga clic en Crear aplicación. Complete un nombre y una descripción, y seleccione un ícono si lo desea. Haga clic en Siguiente.

Seguridad

De manera opcional, puede proteger su aplicación para que pueda ser utilizada solo desde algunos dominios o IPs. Por defecto todos los dominios y todas las IPs están permitidos; con Cambiar agrega los valores permitidos. Haga clic en Guardar.

Llaves

Una vez creada, la aplicación aparece en Mis aplicaciones con sus llaves ocultas. El botón con el ícono de ojo muestra la Auth Key, que le permite consultar los métodos de las APIs, y la llave pública. Al editar la aplicación, el paso Credenciales muestra las mismas llaves y el botón Refrescar, que genera llaves nuevas e invalida las anteriores. Si la cuenta usa OAuth 2.0, en ese mismo paso se muestran el client_id y el client_secret de la aplicación.

Usar la aplicación

La Auth Key se envía en cada solicitud como parámetro auth_key o como cabecera Authorization, según cómo esté configurado cada método. Desde la ficha de un método, Pruebe este método permite elegir la aplicación y ejecutar la solicitud desde el portal. Vea Probar un método.

Resultado esperado

La aplicación queda listada en Mis aplicaciones con su Auth Key disponible, y aparece en el selector de aplicaciones al probar un método. En el video, la aplicación se crea en dos pasos y sus llaves se consultan desde el listado y desde el paso Credenciales.

Errores frecuentes

  • La solicitud responde 401: la Auth Key no corresponde a esta aplicación, fue refrescada, o se envía como parámetro cuando el método la espera en la cabecera.
  • La solicitud responde 403 desde un sitio o servidor: el dominio o la IP de origen no está entre los permitidos de la aplicación.
  • No aparece la aplicación al probar un método: la aplicación pertenece a otro usuario; cada desarrollador prueba con sus propias aplicaciones.

Artículos relacionados