Ir al contenido principal

Cómo entender la API de Amenitiz

Qué es la API de Amenitiz, qué datos puede leer (habitaciones, tarifas, disponibilidad, reservas y facturas), para quién es y cómo empezar. En beta, solo en el plan Advanced.

La API de Amenitiz permite que otro sistema se conecte a tu cuenta de Amenitiz y lea los datos de tu establecimiento: tus habitaciones, tarifas, disponibilidad, reservas y facturas.

La usarías si quieres conectar Amenitiz con una herramienta externa, o si un desarrollador está creando una integración para tu establecimiento. Ponerla en marcha es un trabajo técnico: tú o un desarrollador que trabaje contigo tendréis que programar.

Antes de empezar

La API solo está disponible en el plan Advanced, y solo el propietario de la cuenta puede crear o gestionar credenciales de API. Los miembros del equipo no pueden.

Qué puede leer la API

Al crear una credencial eliges qué puede leer, entre seis áreas:

  • Tipos de habitación y habitaciones

  • Tarifas y ofertas

  • Calendario de disponibilidad

  • Reservas y datos de huéspedes

  • Facturas, recibos y liquidaciones

  • Ajustes del establecimiento y equipo

Las tres últimas incluyen datos personales y sensibles, así que márcalas solo cuando la herramienta las necesite de verdad.


Qué no puede hacer la API

  • No puede cambiar nada en tu cuenta. La API solo lee datos. Las tarifas, la disponibilidad, las reservas y los ajustes se cambian en Amenitiz.

  • No cubre todo lo que ves en Amenitiz. Algunos datos solo están disponibles en la plataforma.

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


Paso a paso

Para empezar:

  1. Comprueba que tu establecimiento está en el plan Advanced y que eres el propietario de la cuenta.

  2. Crea tus credenciales de API en Configuración → Credenciales de API. Amenitiz genera un Client ID y un secreto.

  3. Dale el Client ID y el secreto a tu desarrollador, o pégalos en la herramienta que estás conectando.

  4. Indícale a tu desarrollador la documentación técnica en developers.amenitiz.com.

Este vídeo muestra el proceso paso a paso:

📌 Nota

¿Listo para conectar una herramienta? Consulta Cómo crear y gestionar tus credenciales de API.


¿Necesito un desarrollador para usar la API?

En la mayoría de los casos, sí. La API es una interfaz técnica, así que o bien trabajas con un desarrollador, o bien la herramienta que conectas ya es compatible con la API de Amenitiz. Para crear las credenciales no necesitas a nadie.


¿Puede la API cambiar mis tarifas, disponibilidad o reservas?

No. La API solo lee datos. Cualquier cambio en tus tarifas, disponibilidad, reservas o ajustes hay que hacerlo en Amenitiz.


¿Qué diferencia hay entre la API y el Marketplace?

El Marketplace reúne conexiones ya preparadas con herramientas con las que Amenitiz ya trabaja, y las activas tú sin programar. La API sirve para conectar una herramienta que no tiene una conexión preparada, y requiere trabajo de desarrollo.


Estoy en el plan Advanced pero no veo Credenciales de API

Comprueba que has iniciado sesión como propietario de la cuenta. Si sigues sin verlo, contacta con nuestro equipo de soporte.


¿Cómo consigo acceso a la API, una clave de API o un token?

En Amenitiz, tu clave de API se llama credencial de API: un Client ID y un secreto. El propietario de la cuenta la crea en Configuración → Credenciales de API. Consulta Cómo crear y gestionar tus credenciales de API.


¿Puede mi channel manager u otro proveedor de software conectarse a través de la API?

Sí, si la herramienta solo necesita leer tus datos y es compatible con la API de Amenitiz. La API no puede actualizar tarifas, disponibilidad ni reservas, así que una herramienta que necesite enviar cambios a Amenitiz no puede usarla. Para herramientas que ya funcionan con Amenitiz, revisa primero el Marketplace.

¿Ha quedado contestada tu pregunta?