Claves API
Una clave API permite a un agente de IA o a un script trabajar con tus datos de VillaSlot sin tu contraseña: listar las villas, encontrar franjas libres, crear clientes y reservas. La página Agentes explica cómo conectar un agente; la referencia de la API enumera cada llamada.
Antes de empezar: la organización correcta
Una clave pertenece a una sola organización: la que está seleccionada en tu selector de equipo cuando la creas. Si gestionas varias organizaciones, cambia primero a aquella en la que debe trabajar el agente.
Solo los propietarios y los administradores de esa organización pueden crear, ver y eliminar sus claves.
Crear una clave
Claves API en la sección Cuenta de la barra lateral, y luego Crear clave API.
Nombre de la clave
Un nombre que diga quién la usa, como Claude Code en mi portátil o script de importación de reservas. Es la única forma de distinguir las claves más adelante.
Expiración
Elige una fecha y una hora en Expira el, o marca Nunca expira. Una fecha en el pasado se rechaza.
Crear y luego copiar
Crear muestra Tu nueva clave API. Cópiala ahora y guárdala en un lugar seguro — un gestor de contraseñas, o la variable de entorno que lee tu agente. Listo cierra la ventana.
Es la única vez que ves la clave. Después, la tabla solo muestra La clave está oculta por razones de seguridad. ¿La has perdido? Elimínala y crea una nueva.
Dejar Expira el vacío sin marcar Nunca expira crea una clave que nunca expira. Fija una fecha si el acceso debe ser temporal.
Qué puede hacer la clave
La clave actúa como la persona que la creó, en esa organización: nada más de lo que esa persona podría hacer en la aplicación, nada menos. Si esa persona deja la organización, la clave deja de funcionar al instante.
No todo lo que hace la aplicación está en la API — los pagos, los reembolsos y las estancias por noches, entre otros, se quedan en la aplicación. La página Agentes enumera lo que un agente puede gestionar.
Revocar una clave
La tabla muestra de cada clave su Nombre, su fecha de creación (Creada) y su fecha de expiración (Expira). El botón de eliminar pide confirmación en Eliminar clave API, y luego revoca la clave inmediatamente: cualquier agente o script que todavía la use queda rechazado a partir de ese momento. No se puede deshacer.
Revoca una clave en cuanto deje de usarse, o si ha podido filtrarse — por ejemplo después de pegarla en un prompt compartido o de subirla a un repositorio.