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 app ya está creada cuando creas una nueva cuenta. Usamos esa app para algunos escenarios de reserva.

No puedes reutilizar esta app. Por favor, crea nuevas apps 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 desde 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 app

Como no puedes acceder a la clave secreta de la app 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 app, 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 apps web.
• MACHINE_2_MACHINE — Para integraciones servidor a servidor que se autentican directamente usando credenciales de cliente. Úsalo 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 apps, haz clic en el botón Crear nueva aplicación.
2. Nombre Dale un nombre a tu app. ej. App Genial
3. Tipo de cliente Elige SPA para apps web o MACHINE_2_MACHINE para integraciones servidor.
4. Nombre de entidad Vincula tu app 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 aterricen en una página conocida tras finalizar 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 app en la lista y tendrás acceso a la clave secreta de la app solo esta vez. Asegúrate de copiarla y guardarla en un lugar seguro.

Actualizar app

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

Para actualizar una app existente, haz lo siguiente:

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

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

Eliminar app

Precaución

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

Si ya no necesitas una app, puedes eliminarla.

Para eliminar una app, haz lo siguiente:

1. Haz clic en el enlace Acciones para la app 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.