API pública: conectá Hospeda con otros sistemas
Si alguien de sistemas quiere integrar tu web o un software externo con Hospeda, generá una API key desde Ajustes y consultá la documentación técnica dentro del panel.
Video próximamente
Mientras tanto, seguí los pasos de abajo.
- 1
Entendé para qué sirve
La API pública le permite a un sistema externo hablar con Hospeda: consultar disponibilidad, cotizar precios, crear reservas y recibir avisos automáticos (webhooks) cuando pasa algo (una reserva nueva, por ejemplo). Es para cuando vos, o alguien de sistemas o desarrollo que contrates, quiere conectar tu propia web, un asistente o un software externo con tu Hospeda — no hace falta para usar el panel día a día.
- 2
Andá a «Ajustes → API»
La pestaña se llama «API» (adentro vas a ver la tarjeta «API & Integraciones»). La API es parte del plan Completo, y la pestaña solo la ve el dueño de la cuenta: si tenés el plan Inicial no te va a aparecer. Ahí armás y administrás tus API keys.
- 3
Creá una API key
Cargá un «Nombre» que la identifique (por ejemplo, el nombre de la integración), elegí el «Alcance» — toda la cuenta o una sucursal puntual — y tildá los «Permisos» que va a necesitar esa integración: «Consultar disponibilidad», «Cotizar precios», «Ver catálogo de unidades», «Ver promociones vigentes», «Leer reservas» y «Crear reservas». Si querés probar la integración sin que las reservas se guarden ni bloqueen fechas, tildá «Modo prueba (sandbox)» (genera una key `hsp_test_…` y el botón pasa a decir «Generar API key de prueba»). Tocá «Generar API key».
- 4
Guardala apenas se genera
La API key se muestra una sola vez, con un botón «Copiar». Si la perdés, no hay forma de volver a verla: tenés que generar una nueva.
- 5
Administrá tus API keys activas
En el listado ves cuándo se usó cada una por última vez. Tocá «Revocar» para dar de baja la que ya no necesites: la integración que la estaba usando deja de funcionar al instante.
- 6
Configurá webhooks (avisos automáticos)
Los webhooks no son un permiso de la key: se arman en una sección aparte «Webhooks» dentro de la misma pestaña «API». Tocá «Nuevo webhook», cargá la «URL del endpoint» (a dónde te avisamos), una «Descripción (opcional)» y elegí los «Eventos» (Reserva creada, confirmada, pagada o cancelada, Check-in y Check-out) → «Crear webhook». Al crearlo se muestra una sola vez el «secret de firma»: copialo y guardalo, sirve para validar que el aviso vino de Hospeda.
- 7
Pasale la documentación a quien programe la integración
El botón «Ver documentación» del panel abre la guía técnica completa (endpoints, formatos y ejemplos) para la persona que vaya a programar la conexión.