Desarrolladores

La API pública de Stayo

La API REST pública de Stayo le permite crear sus propias integraciones, aplicaciones e informes sobre reservas, huéspedes, habitaciones y tarifas. Autenticación con clave API.

Base URLhttps://api.stayo.se/public/v1/

¿Qué puede construir?

Integraciones propias

Conecte Stayo con sus sistemas existentes — CRM, marketing automation, ERP o sus propias herramientas.

Aplicaciones propias

Cree interfaces propias para recepción, limpieza o dirección sobre los mismos datos que usa Stayo.

Informes y BI

Extraiga reservas, ocupación e ingresos a Power BI, Looker Studio, Excel o su propio almacén de datos.

Automatización

Active flujos de trabajo en Make, Zapier o n8n ante nuevas reservas, llegadas o pagos.

Autenticación

Todas las llamadas se autentican con una clave API que crea en Configuración → Desarrolladores en Stayo. Envíe la clave como token Bearer en el encabezado Authorization.

• Claves separadas para prueba y producción (sk_test_… / sk_live_…).
• La clave solo se muestra una vez — guárdela de forma segura.
• Siempre enviada por HTTPS. Nunca en código de cliente ni en la URL.
• Puede renovarse o revocarse en cualquier momento.

curl https://api.stayo.se/public/v1/bookings \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx" \
  -H "Accept: application/json"

Endpoints (selección)

API REST con JSON. La especificación OpenAPI completa se proporciona a los integradores activos.

Método	Ruta	Descripción
GET	/bookings	Listar reservas con filtros por fecha, estado y canal.
POST	/bookings	Crear una nueva reserva.
GET	/bookings/{id}	Obtener una reserva.
PATCH	/bookings/{id}	Actualizar estado, fechas o datos del huésped.
GET	/guests	Buscar y listar huéspedes.
GET	/rooms	Listar habitaciones, tipos de habitación y disponibilidad.
GET	/rates	Obtener tarifas y reglas de precios.
GET	/invoices	Listar facturas y recibos.
POST	/webhooks	Registrar webhooks para eventos en tiempo real.

Ejemplo de respuesta

{
  "data": [
    {
      "id": "bk_01HXYZ...",
      "status": "confirmed",
      "channel": "booking.com",
      "arrival": "2026-08-12",
      "departure": "2026-08-15",
      "guest": { "name": "Anna Andersson", "email": "anna@example.com" },
      "room": { "id": "rm_12", "type": "Dubbelrum" },
      "total": { "amount": 4200, "currency": "SEK" }
    }
  ],
  "meta": { "page": 1, "per_page": 50, "total": 128 }
}

Límites de velocidad

60 llamadas por minuto y clave API por defecto. El estado actual se encuentra en los encabezados de respuesta X-RateLimit-Remaining y X-RateLimit-Reset. ¿Necesita más? Contáctenos.

Versionado

La versión se indica en la URL (/public/v1/). Los cambios no disruptivos pueden añadirse dentro de la misma versión. Los cambios disruptivos solo llegan en nuevas versiones con al menos 6 meses de solapamiento.

Webhooks

Suscríbase a eventos como booking.created, booking.updated y payment.succeeded. Todos los webhooks están firmados con HMAC-SHA256.

Empiece con la API

La API está disponible para los clientes de Stayo a partir del plan Growth. Contáctenos y activaremos el acceso, enviaremos la especificación OpenAPI y le ayudaremos a empezar.

Contáctenos hej@stayo.se