Creando Apps

Para registrar una nueva aplicación, basta hacer clic en el botón Create app, representado por el icono icon create app en la esquina inferior derecha de la página Apps. Se mostrará una pantalla con el proceso, que implica tres etapas: Basic info, APIs and Plans, Overview.

Basic info (Informaciones básicas)

create app

La primera etapa, Basic Info, consiste en los siguientes campos y secciones:

  • Name: identifica la aplicación con un nombre único.

  • Description: campo requerido que ayuda a identificar una aplicación.

  • Status: campo requerido que define el estado de cada aplicación en términos de capacidad de uso.

    • Approved: la aplicación está disponible para su uso;

    • Approved: la aplicación está esperando la aprobación o el rechazo;

    • Rejected: la aplicación estaba pendiente anteriormente y ahora es rechazada;

    • Cancelled: la aplicación no está permitida para ser utilizada.

  • Developer: campo para identificar al desarrollador de la aplicación. Puede asumir dos comportamientos:

    • Puede enlazar un client ID a un usuario del Portal de Desarrollador. Este campo también tiene una función de autocompletar con una lista de todos los usuarios registrados en el Portal de Desarrollador, que se puede ver en la pantalla Developers del Manager.

    • En caso de que un usuario específico quiera acceder al client ID y/o client secret, se requiere la inserción de una dirección de correo electrónico.

  • Client ID y Client Secret: los valores pueden ser insertados manualmente por el usuario, y los campos solo aceptan letras y números. Si no se introduce ningún valor, el Manager los genera automáticamente, lo que garantiza la unicidad.

  • Link to App Store or App Site: si hay un enlace a la aplicación publicada, insertar aquí.

  • Show this App in Gallery?: si la opción está seleccionada, la aplicación se mostrará en la galería de aplicaciones del Portal de Desarrollador.

Sección EXTRA FIELDS

Esta sección contiene campos no obligatorios que agregan valores adicionales, complementando la información del client ID (por ejemplo, un ID adicional o un número de registro de la aplicación).

Los campos adicionales se pueden informar a través de query params en solicitudes REST, por ejemplo, para buscar una aplicación específica. En este caso, debe utilizar extraFields en el formato clave:valor.

Sección INBOUND ADDRESS

En esta sección es posible definir las direcciones de entrada a las que la app tendrá acceso. Las direcciones de entrada seleccionadas aquí determinarán en qué data planes la app y sus credenciales serán replicadas. Al restringir la implementación de la app a uno o más data planes, usted puede controlar a qué recursos podrá acceder y en qué entornos se almacenará su información (como sus credenciales).

Para seleccionar las direcciones de entrada a las que la app podrá acceder, siga los siguientes pasos:

Agregar y gestionar direcciones de entrada
  1. Haga clic en el botón + Add inbound address, ubicado en la esquina superior derecha de esta sección.

  2. Se abrirá una ventana modal que le permitirá elegir las direcciones de entrada disponibles. Seleccione las direcciones de entrada deseadas haciendo clic en las casillas de verificación correspondientes.

No es posible asociar una app a una dirección de entrada que no tenga el campo Data Plane completado.
  1. Después de seleccionar todas las direcciones de entrada deseadas, haga clic en el botón Confirm para guardar sus elecciones.

add inbound address

Las direcciones de entrada seleccionadas (y, por lo tanto, a las que la app tendrá acceso) se mostrarán con su información básica en una lista en la sección INBOUND ADDRESS.

Es posible eliminar una dirección de entrada de la lista haciendo clic en el icono icon delete ubicado en la última columna de la fila correspondiente.

  • Remover una inbound address de la lista ahora interrumpe futuras actualizaciones de la aplicación en ese data plane, sin embargo, los datos existentes de la aplicación permanecen almacenados.

  • Este campo es opcional y avanzado. La selección de inbound address restringe en qué data planes la App estará visible y accesible.

  • La selección de direcciones de entrada no es obligatoria. Si no se selecciona ninguna dirección de entrada, la app se replicará en todos los data planes disponibles.


Para avanzar a la siguiente etapa del registro de la app, haga clic en el botón Save and next, ubicado en la esquina inferior derecha de la pantalla.

APIs and Plans

El segundo paso es la pantalla APIs and Plans, donde puede seleccionar las APIs que la app consumirá y los planes que debe seguir.

Las API que están disponibles en su Manager se mostrarán en tarjetas, organizadas en orden de última alteración realizada en las APIs. Por defecto, la pantalla mostrará 10 tarjetas. Puede cambiar la cantidad de tarjetas que se muestran en la pantalla haciendo clic en el botón Show, que se encuentra debajo de las API. También puede pasar a la siguiente página de APIs mediante el botón Next o a la anterior con el botón Prev. Para saltar a una página concreta, introduzca el número de la página y haga clic en Jump to page.

create app plans

Puede seleccionar las APIs en lista de tarjetas directamente o usar el campo de búsqueda para filtrar las APIs por nombre, lo que facilita encontrar la API deseada si tiene muchas registradas. Se puede limpiar la búsqueda actual haciendo clic en el botón Clear; en este caso, se volverá a mostrar la lista inicial de cartas.

Para seleccionar una API, basta elegir un plano o todos haciendo clic en Select All dentro de la tarjeta de la API, una vez hecho esto la API y el plano elegido quedarán activos y guardados. Se pueden seleccionar varias APIs para la app, las elegidas se mostrarán en la sección Current Plans and APIs encima del campo de búsqueda, y sus tarjetas indicarán los planes elegidos.

Si no se selecciona ninguna API (y, en consecuencia, ningún plan), la aplicación se creará, pero no podrá consumir ninguna API. Puede vincular la app a una API en otro momento, a través de la edición de apps.

Si desea eliminar la API que acaba de seleccionar, basta desactivar los planes elegidos o puede clicar en Select All en la tarjeta de la API, para removerlos todos de una vez.

Tenga en cuenta que las tarjetas de APIs de la lista pueden contener dos tipos de advertencia:

  • Si desea vincular una aplicación a una API que no contiene ningún plan, la tarjeta mostrará este mensaje: «To consume this API, it needs to have a plan. You can finish creating your APP and after the API has a plan, you can edit your APP and link it to the plan you want.». Necesitará crear un plan de antemano para poder vincular esta API a tu app.

  • Una tarjeta contendrá el icono icon old cuando la API en cuestión sea una versión anterior de otra API registrada.

Una vez que haya elegido las APIs y los planes deseados, haga clic en el botón Publish your app, hecho esto su app será publicada y sera dirigido a la pantalla de Overview.

Overview (Visión general)

El tercer y ultimo paso es la pantalla de Overview.

success screen app

Esta pantalla muestra los datos insertados durante la creación de la App incluido las APIs y planos escogidos. El client ID, Client secret y el Code Base 64 se pueden copiar al portapapeles haciendo clic en el icono al lado de ellos.

Si desea modificar cualquier información, puede volver a los pasos anteriores haciendo clic en la etapa deseada en la barra superior del wizard y realizar la edición. Para finalizar el Wizard y salvar su App, basta clicar el botón Done y será redirigido a la lista de Apps.

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]