Ir al contenido

Aplicaciones

Las aplicaciones te dan acceso a todas las funciones de Wink como desarrollador. Puedes acceder a todos los mismos datos e incluso ampliar las propias funciones 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.

Aplicación de ejemplo
Entrada de aplicación de ejemplo
  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 mostrará todas tus aplicaciones.
  5. Rota o elimina una existente, o crea una nueva.

Como no puedes acceder a la clave secreta de la aplicación que creamos para ti, necesitarás crear la tuya propia. Puedes crear una aplicación aquí sin configurar primero una propiedad o empresa — no está vinculada a ninguna cuenta específica.

Al crear una aplicación, eliges un tipo de cliente que determina cómo se autentica la aplicación. Esto no puede cambiarse después — si necesitas un tipo diferente, crea una nueva aplicación.

  • Aplicación web — Una aplicación renderizada en servidor que puede mantener de forma segura un secreto de cliente (flujo de código de autorización).
  • Aplicación de una sola página (SPA) — Una aplicación en navegador sin backend; usa PKCE, sin secreto de cliente.
  • Aplicación móvil — Una aplicación nativa iOS/Android; usa PKCE con tokens de actualización rotativos.
  • Máquina a máquina — Un servicio backend que actúa por sí mismo (credenciales de cliente); sin inicio de sesión de usuario.

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 el tipo que coincida con cómo se autentica tu aplicación — consulta Tipos de cliente arriba.
  4. URIs de redirección Se requiere al menos una URI de redirección. Se usa para validar el dominio de redirección tras una autenticación exitosa. No se usa para aplicaciones máquina a máquina. ej. https://www.sitio-genial.com
  5. URIs de redirección post-cierre de sesión (Opcional) URLs a las que se puede redirigir a los usuarios después de cerrar sesión. Déjalo en blanco para reutilizar las URIs de redirección anteriores.
  6. Scopes Elige a qué puede acceder esta aplicación en tu nombre — consulta Elección de scopes abajo.
  7. Haz clic en el botón Crear aplicación para continuar.

Serás redirigido de vuelta a tu lista de aplicaciones, y un diálogo único mostrará el nuevo Client ID y Client secret. Copia el secreto ahora y guárdalo en un lugar seguro — nunca se muestra de nuevo, y no hay forma de recuperarlo después (solo puedes rotarlo para obtener uno nuevo).

Cada aplicación siempre lleva los scopes Inicio de sesión (OpenID Connect) (openid, profile, email, offline_access) — estos confirman la identidad del usuario y mantienen la sesión iniciada, por lo que aparecen marcados y bloqueados; no son opcionales.

Todo lo demás es optativo. Los scopes restantes están agrupados en las mismas secciones funcionales documentadas en Scopes — Cuenta, Inventario y tarifas, Reservas, Marketing y promociones, Contenido de propiedad, Análisis e informes, Integraciones con gestores de canales, Pagos, y Contabilidad y libro mayor — cada uno con una descripción en lenguaje sencillo de lo que desbloquea. Usa los enlaces Todos / Ninguno sobre la lista para seleccionar o desmarcar todos los scopes opcionales a la vez.

Dos familias de scopes no se ofrecen deliberadamente en este formulario:

  • mcp.* — acceso de agentes de IA al transporte Model Context Protocol. No creas una aplicación para esto: un cliente de IA como Claude, ChatGPT o Codex se registra a sí mismo y solicita estos scopes cuando inicias sesión a través de la pantalla de consentimiento MCP. Nunca se otorgan a aplicaciones máquina a máquina, porque MCP siempre actúa en nombre de un usuario autenticado.
  • Scopes de nivel administrador (administrator.*) — acceso a nivel plataforma que no se otorga por aplicación.

Una vez creada una aplicación, tanto esta pestaña como Aplicaciones consentidas muestran sus scopes otorgados agrupados por sección (ej. “Reservas: booking.read”), para que puedas ver qué puede hacer una aplicación de un vistazo sin abrirla.

Si un secreto de cliente pudo haberse filtrado, o simplemente quieres credenciales nuevas, rótalas en lugar de recrear la aplicación:

  1. Encuentra la aplicación en tu lista de aplicaciones y haz clic en Rotar.
  2. Confirma el diálogo — el Client ID y secreto actuales dejan de funcionar inmediatamente.
  3. Copia el nuevo Client ID y secreto del diálogo único antes de cerrarlo.

Rotar mantiene el nombre de la aplicación, tipo de cliente, URIs de redirección y scopes — solo cambian las credenciales.

Si ya no necesitas una aplicación, puedes eliminarla. Esto es permanente — las credenciales se revocan inmediatamente y no pueden recuperarse.

  1. Encuentra la aplicación en tu lista de aplicaciones y haz clic en Eliminar.
  2. Confirma el diálogo para eliminar permanentemente la aplicación.