Las credenciales de API son como un usuario y una contraseña que permiten que otro sistema se conecte a tu cuenta de Amenitiz y lea los datos de tu establecimiento, como tus habitaciones, tarifas, disponibilidad, reservas y facturas. Una credencial solo lee: nada de lo que conectes así puede cambiar nada en Amenitiz.

Las usarías si quieres conectar Amenitiz con una herramienta externa, o si un desarrollador está creando una integración para tu establecimiento. ¿No conoces la API? Empieza por Cómo entender la API de Amenitiz.

Antes de empezar

La API de Amenitiz está en beta y aún se está desplegando, así que algunos detalles pueden cambiar.

Para crear credenciales de API tienes que estar en el plan Advanced y ser el propietario de la cuenta. Los miembros del equipo no pueden crear ni gestionar credenciales.

Ten a mano tu contraseña de Amenitiz: te la pediremos para terminar.

Paso a paso

Ve a Configuración.
Abre Credenciales de API.
Haz clic en Nueva credencial.
Ponle un nombre que reconozcas más adelante, por ejemplo la herramienta que estás conectando, como "Exportación contable".
En ¿Qué puede leer?, marca solo lo que la herramienta te haya pedido; tienes que marcar al menos una cosa. Puedes cambiarlo más adelante.
Si tienes más de un establecimiento, marca cuáles cubre la credencial en ¿Qué establecimientos?. Con un solo establecimiento no hay nada que elegir.
Haz clic en Crear credencial.
Introduce tu contraseña de Amenitiz cuando aparezca Confirma que eres tú y vuelve a hacer clic en Crear credencial.
Copia el Client ID y el secreto, o haz clic en Descargar como archivo para guardarlos.
Haz clic en Listo.

📌 Nota

No hay nada que memorizar. Si pierdes el secreto, abre la credencial de nuevo y Amenitiz te lo mostrará después de comprobar tu contraseña.

Ya puedes darle el Client ID y el secreto a tu desarrollador, o pegarlos en la herramienta que estás conectando.

Elegir qué puede leer una credencial

Una credencial solo lee lo que marques, así que marca solo lo que la herramienta te haya pedido. Las seis opciones son:

Tipos de habitación y habitaciones: los detalles de tu establecimiento, tus tipos de habitación y las habitaciones individuales que contienen.
Tarifas y ofertas: planes de tarifas, extras, promociones y condiciones de venta.
Calendario de disponibilidad: día a día, qué está libre, el precio y cualquier estancia mínima.
Reservas y datos de huéspedes: reservas, cargos y pagos, incluidos el nombre, correo electrónico, teléfono y dirección de cada huésped, y cualquier cosa que hayan escrito en sus solicitudes.
Facturas, recibos y liquidaciones: las facturas, recibos y notas de crédito que has emitido, incluidos los datos de facturación de tus clientes, y tu cuenta de liquidación.
Ajustes del establecimiento y equipo: horarios de check-in, correos automatizados, y los nombres, correos electrónicos y permisos de tu equipo.

🚫 Advertencia

Las tres últimas opciones incluyen datos personales y sensibles. Tus huéspedes nunca aceptaron compartir sus datos con la herramienta que estás conectando: tú decides por ellos. Marca Reservas y datos de huéspedes, Facturas, recibos y liquidaciones y Ajustes del establecimiento y equipo solo cuando la herramienta los necesite de verdad.

Gestionar tus credenciales

Al abrir una credencial puedes:

Copiar el Client ID.
Mostrar el secreto para verlo otra vez, y Ocultarlo cuando termines.
Reemplazar el secreto por uno nuevo. Hazlo si crees que tu secreto se ha compartido o filtrado. El Client ID sigue siendo el mismo, solo cambia el secreto, y cualquier herramienta que siga usando el secreto antiguo pierde el acceso hasta que pegues el nuevo.
Revocar la credencial para desactivarla de forma permanente. Amenitiz te pide que escribas el nombre de la credencial para confirmar, y luego cualquier herramienta que la use pierde el acceso de inmediato.
Cambiar qué puede leer la credencial, marcando o desmarcando las mismas seis opciones, y cambiar qué establecimientos cubre.

⚠️ Importante

Amenitiz te pide que confirmes la contraseña de tu cuenta antes de mostrar o reemplazar un secreto. El secreto da acceso a los datos de tu establecimiento, así que comprobamos que eres tú.

📌 Nota

Quitar acceso se aplica de inmediato y la herramienta se desconecta hasta que vuelva a conectarse. Añadir acceso solo le llega la próxima vez que se conecte.

Mantener tus credenciales seguras

Trata el secreto como una contraseña:

No lo compartas nunca en público ni lo envíes por correo o chat sin cifrar.
Dáselo solo a herramientas y personas en las que confíes.
Si crees que ha quedado expuesto, reemplázalo de inmediato.

Para desarrolladores

La documentación técnica completa está en developers.amenitiz.com.

Amenitiz no ofrece soporte técnico para implementaciones de la API. Es una integración avanzada que se ofrece en modo autoservicio.

Estoy en el plan Advanced pero no veo Credenciales de API

La API aún se está desplegando, así que puede que todavía no haya llegado a tu cuenta. Comprueba que has iniciado sesión como propietario de la cuenta y luego contacta con nuestro equipo de soporte.

¿Puede un miembro del equipo crear credenciales de API?

No. Solo el propietario de la cuenta puede crear una credencial, mostrar o reemplazar un secreto, o revocar una credencial.

He perdido el secreto. ¿Qué hago?

Abre la credencial y haz clic en Mostrar, y luego confirma la contraseña de tu cuenta. No has perdido nada: solo tienes que reemplazar el secreto si crees que lo ha visto alguien más.

¿Puedo cambiar lo que puede leer una credencial después de crearla?

Sí. Abre la credencial y marca o desmarca las opciones. Quitar acceso se aplica de inmediato; añadir acceso le llega a la herramienta la próxima vez que se conecte.

¿Debo crear una credencial por herramienta?

Sí. Una credencial por herramienta te permite reemplazar o revocar una sin cortar las demás, darle a cada herramienta solo el acceso que necesita y ver de un vistazo a qué herramienta corresponde cada credencial.

He revocado una credencial por error. ¿Puedo reactivarla?

No. Revocar es permanente. Crea una credencial nueva y dale el nuevo Client ID y secreto a la herramienta o al desarrollador.

Cómo crear y gestionar tus credenciales de API