Portal para Desarrolladores Hotel Bergsonne Allgäu — API de reservas, MCP y OpenAPI

Esta página es el punto de entrada para agentes IA, chatbots y socios de integración. Todos los endpoints de lectura son públicos y sin autenticación; las reservas usan una ruta de escritura documentada.

Cuándo usar esta API

Consultar disponibilidad y tarifas en vivo para fechas concretas en Sonthofen, Allgäu.
Describir tipos de habitación, ocupación, equipamiento, accesibilidad y la habitación de cuidados.
Responder sobre horarios de llegada, contacto y datos del establecimiento.
Iniciar una reserva directa o derivar al huésped al proceso de reserva.

Cuándo no usar esta API

Para otros hoteles o búsquedas multipropiedad: esta API describe solo el Hotel Bergsonne Allgäu.
Para cancelar o modificar reservas existentes: por correo o teléfono.
Para procesar pagos, datos de huéspedes o sistemas internos.
Para consultas masivas sin intención de viaje: se aplica un límite de solicitudes.

Inicio rápido

Tres pasos: leer datos del hotel, comprobar disponibilidad, confirmar precio. Parámetros sin distinción de mayúsculas, precios en EUR con IVA.

Hotel & room typeshttps://bergsonne-allgaeu.de/api/booking?action=hotel
Availabilityhttps://bergsonne-allgaeu.de/api/booking?action=availability&checkIn=2026-08-20&checkOut=2026-08-23&adults=2
Price quotehttps://bergsonne-allgaeu.de/api/booking?action=price-quote&roomId=KDZ&checkIn=2026-08-20&checkOut=2026-08-23&adults=2
Bookable extrashttps://bergsonne-allgaeu.de/api/booking?action=addons
Create booking (POST)https://bergsonne-allgaeu.de/api/booking?action=bookings

Autenticación

La lectura es abierta: hotel, fact-sheet, availability, price-quote, addons y discover-rooms no requieren token. La escritura (action=bookings) usa POST; detalles OAuth 2.1 en /.well-known/oauth-protected-resource y /.well-known/auth.md.

Scopes y mínimo privilegio

Los scopes OAuth con nombre están declarados de forma legible por máquina: scopes_supported en /.well-known/oauth-protected-resource (RFC 9728) y esquema de seguridad OAuth en /api/openapi. Los agentes solo piden el scope mínimo.

hotel:readHotel metadata, room types, amenities, fact sheet, extras
booking:readAvailability, rates, price quotes
booking:writeCreate a reservation for a named human guest

Registro self-service sin formulario ni aprobación humana: POST /agent/auth devuelve una credencial bearer anónima con hotel:read y booking:read. booking:write usa el flujo OAuth con PKCE (S256), porque la reserva es a nombre de un huésped concreto.

Sandbox e idempotencia

Con "test": true en el cuerpo de la reserva la petición se ejecuta en modo sandbox: validación y cálculo idénticos, sin reserva real y con un bookingId TEST. Una "idempotencyKey" por intento evita duplicados.

POST https://bergsonne-allgaeu.de/api/booking?action=bookings
Content-Type: application/json

{
  "roomId": "KDZ",
  "rateId": "1",
  "checkIn": "2026-08-20",
  "checkOut": "2026-08-23",
  "adults": 2,
  "customer": {
    "firstName": "Max",
    "lastName": "Mustermann",
    "email": "max@example.com",
    "phone": "+49 170 1234567",
    "country": "DE"
  },
  "idempotencyKey": "8f1c0e2a-...",
  "test": true
}

Errores y límites de solicitudes

Los errores siempre son JSON con los campos error, code, hint, docs y openapi. Una acción desconocida devuelve HTTP 400 con code UNKNOWN_ACTION, una ruta /api/ desconocida HTTP 404 con NOT_FOUND. Demasiadas peticiones devuelven HTTP 429 con RATE_LIMITED.

INVALID_DATESHTTP 400
UNKNOWN_ACTIONHTTP 400
METHOD_NOT_ALLOWEDHTTP 405
FORBIDDEN_ORIGINHTTP 403
NOT_FOUNDHTTP 404
RATE_LIMITEDHTTP 429
UPSTREAM_ERRORHTTP 502

Archivos legibles por máquina

Contacto técnico

Preguntas sobre integración, límites o acceso de escritura: escribe a servus@bergsonne-allgaeu.de o llama al +49 8321 3360.