Aplicaciones

Las aplicaciones te dan acceso a todas las funciones de Wink como desarrollador. Puedes acceder a todos los mismos datos e incluso extender las funciones propias de Wink. Puedes elegir usar el servidor OAuth2 de Wink para autenticar tu sitio de viajes de la misma manera que usarías Google o Facebook. De esta forma puedes extender las funciones de Wink en tu propio sitio web o aplicación.

Nota

Tu primera aplicación ya está creada cuando creas una nueva cuenta. Usamos esta aplicación para algunos escenarios de reserva.

No puedes reutilizar esta aplicación. Por favor crea nuevas aplicaciones según las necesites.

Entrada de aplicación de ejemplo

Nota

Una aplicación generada en Wink puede usarse para todos los endpoints de la API.

1. Selecciona la cuenta con la que quieres trabajar desde Cuentas.
2. Haz clic en Acciones en la parte inferior de la tarjeta de la cuenta y elige Administrar cuenta.
3. Haz clic en la pestaña Aplicaciones en la página siguiente.
4. Esta sección listará todas tus aplicaciones.
5. Elige editar una existente o crear una nueva.

Crear aplicación

Como no puedes acceder a la clave secreta de la aplicación que creamos para ti, necesitarás crear la tuya propia.

Precaución

Necesitas crear una cuenta afiliada en Wink o una cuenta en TripPay antes de crear una aplicación, ya que vincularás tu aplicación a una cuenta específica.

Tipos de cliente

Al crear una aplicación, eliges un tipo de cliente que determina cómo se autentica la app:

• SPA (Single Page Application) — Para aplicaciones frontend basadas en navegador que usan el flujo de código de autorización OAuth2 con PKCE. Este es el tipo más común para aplicaciones web.
• MACHINE_2_MACHINE — Para integraciones servidor a servidor que se autentican directamente usando credenciales de cliente. Usa esto cuando tu servicio backend necesite llamar a las APIs de Wink sin que haya un usuario presente.

Aquí están los pasos para crear una aplicación:

1. Desde la página de aplicaciones, haz clic en el botón Crear nueva aplicación.
2. Nombre Dale un nombre a tu aplicación. ej. Aplicación Genial
3. Tipo de cliente Elige SPA para aplicaciones web o MACHINE_2_MACHINE para integraciones servidor.
4. Nombre de entidad Vincula tu aplicación con una de tus cuentas existentes. ej. Cuenta Genial
5. URIs de redirección Se requiere al menos una URI de redirección. Se usa para validar el dominio de redirección después de una autenticación exitosa. ej. https://www.sitio-genial.com
6. URIs de redirección post-cierre de sesión (Opcional) URLs a donde se puede redirigir a los usuarios después de cerrar sesión. Esto asegura que los usuarios lleguen a una página conocida tras terminar su sesión.
7. Haz clic en el botón Guardar para continuar.

Serás redirigido de vuelta a tu lista de aplicaciones. Verás tu nueva aplicación en la lista y tendrás acceso a la clave secreta de la aplicación solo esta vez. Asegúrate de copiarla y guardarla en un lugar seguro.

Actualizar aplicación

Necesitarás actualizar tu aplicación si cambia alguna de tus URIs de redirección o si quieres agregar o eliminar una URI.

Para actualizar una aplicación existente, haz lo siguiente:

1. Haz clic en el enlace Acciones para la aplicación que quieres actualizar.
2. Haz clic en el botón Actualizar bajo Acciones.
3. Realiza los cambios en la aplicación.
4. Haz clic en el botón Guardar para continuar.

Serás redirigido de vuelta a tu lista de aplicaciones.

Eliminar aplicación

Precaución

Por favor no elimines la aplicación que creamos automáticamente para ti para asegurar que todas las funciones funcionen para tu cuenta.

Si ya no necesitas una aplicación, puedes eliminarla.

Para eliminar una aplicación, haz lo siguiente:

1. Haz clic en el enlace Acciones para la aplicación que quieres eliminar.
2. Haz clic en el botón Eliminar bajo Acciones.
3. Haz clic en el botón OK para confirmar la eliminación.

Serás redirigido de vuelta a tu lista de aplicaciones.