Gestión de Claves de API para Integraciones

Diríjase al Marketplace de Integraciones

Vaya a la sección de “Integraciones” o “Marketplace” de su sistema.

Localice e instale el módulo de API Keys

Busque la opción “Integraciones Generales (API Keys)” dentro de las integraciones disponibles y seleccione “Instalar”.

Acepte los términos y condiciones

Acepte los términos y condiciones del servicio que se presentan en la ventana emergente. Esta ventana le informa sobre el costo asociado al servicio y los detalles del contrato.Marque la casilla de aceptación y presione “Instalar” para continuar.

Lea atentamente los términos y condiciones, ya que la instalación de este módulo podría implicar costos asociados al servicio.

Verifique la instalación

Una vez instalado, el sistema le redirigirá automáticamente a la pantalla de gestión “Mis API Keys”, donde podrá crear y administrar sus claves.

Confirme que ha sido redirigido a la pantalla “Mis API Keys” y que ve el botón “Crear API Key”.

Inicie la creación de una nueva clave

Haga clic en el botón “Crear API Key” para iniciar el proceso de creación de una nueva clave.

Configure los detalles de la clave

Complete el formulario “Crear nueva API Key” con los detalles de su nueva clave.

Debe definir los siguientes campos:

• Nombre: Asigne un nombre descriptivo que le permita identificar el propósito de la clave, por ejemplo, “API key de prueba para CRM”.
• Usuario asociado: Seleccione un usuario existente del sistema. La clave de API operará con los permisos de este usuario. Todas las acciones realizadas a través de la API se registrarán como si las hubiera hecho el usuario seleccionado.
• Expiración: Establezca un período de validez para la clave.
  Se recomienda seleccionar un período de expiración definido (por ejemplo, “12 meses”) para mejorar la seguridad y requerir una rotación periódica de claves.
• Alcance: Defina a qué recursos tendrá acceso la clave.
  • Implícito: Otorga acceso a todos los recursos de la propiedad actual.
  • Explícito: Le permite restringir el acceso a empresas y establecimientos específicos, lo cual es útil en entornos con múltiples propiedades.
• Entorno: Seleccione “Producción” para que la clave sea funcional en el ambiente operativo real.

Defina los permisos específicos: Despliegue cada sección (por ejemplo, “Hotel”, “Reservas”) y active los interruptores para conceder las autorizaciones necesarias. Esto le permite un control granular sobre las acciones que la integración externa podrá realizar, como “Consultar disponibilidad”, “Ver datos del hotel”, “Crear reservas” o “Listar reservas”.

Genere la clave de API

Una vez que haya configurado todos los detalles y permisos, haga clic en el botón “Crear API Key” en la parte inferior del formulario para generar la clave.

Copie y guarde el token de acceso

Copie el token de acceso generado que se muestra en la ventana emergente. Este token es su clave de API y solo se mostrará una vez por motivos de seguridad.

Es fundamental copiar este token y guardarlo en un lugar seguro inmediatamente. No será posible recuperarlo después de cerrar esta ventana.

Cierre la ventana de confirmación

Cierre la ventana de confirmación. El sistema le advertirá que la clave no se podrá volver a ver. Confirme la acción seleccionando “Sí, ya copié”.

Asegúrese de haber copiado y guardado su token de acceso antes de confirmar.

Verifique la clave en la lista

La nueva clave de API aparecerá listada en la pantalla “Mis API Keys”, mostrando su nombre, estado (Activo) y fecha de expiración. Desde aquí, usted puede gestionarla, ver sus detalles o revocarla si es necesario.

Confirme que la nueva API Key ha sido creada y aparece correctamente en la lista.

Utilizar el apikey