Portale Sviluppatori Hotel Bergsonne Allgäu — API di prenotazione, MCP e OpenAPI

Questa pagina è il punto di ingresso per agenti IA, chatbot e partner di integrazione. Tutti gli endpoint di lettura sono pubblici e senza autenticazione; le prenotazioni usano un percorso di scrittura documentato.

Quando usare questa API

Interrogare disponibilità e tariffe in tempo reale per date precise a Sonthofen, Allgäu.
Descrivere tipi di camera, occupazione, dotazioni, accessibilità e la camera per assistenza.
Rispondere su orari di arrivo, contatti e dati della struttura.
Avviare una prenotazione diretta o passare l'ospite al percorso di prenotazione.

Quando non usare questa API

Per altri hotel o ricerche multi-struttura: questa API descrive solo l'Hotel Bergsonne Allgäu.
Per annullare o modificare prenotazioni esistenti: via e-mail o telefono.
Per pagamenti, dati degli ospiti o sistemi interni.
Per interrogazioni massive senza intento di viaggio: si applica un rate limit.

Avvio rapido

Tre passi: leggere i dati della struttura, verificare la disponibilità, confermare il prezzo. Parametri case-insensitive, prezzi in EUR IVA inclusa.

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

Autenticazione

La lettura è aperta: hotel, fact-sheet, availability, price-quote, addons e discover-rooms non richiedono token. La scrittura (action=bookings) usa POST; dettagli OAuth 2.1 in /.well-known/oauth-protected-resource e /.well-known/auth.md.

Scope e privilegio minimo

Gli scope OAuth nominati sono dichiarati in modo leggibile dalle macchine: scopes_supported in /.well-known/oauth-protected-resource (RFC 9728) e schema di sicurezza OAuth in /api/openapi. Gli agenti richiedono solo lo scope minimo.

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

Registrazione self-service senza moduli né approvazione umana: POST /agent/auth restituisce una credenziale bearer anonima con hotel:read e booking:read. booking:write usa il flusso OAuth con PKCE (S256), perché la prenotazione è a nome di un ospite identificato.

Sandbox e idempotenza

Con "test": true nel corpo della prenotazione la richiesta gira in modalità sandbox: validazione e calcolo identici, nessuna prenotazione reale e un bookingId TEST nella risposta. Una "idempotencyKey" per tentativo evita duplicati.

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
}

Errori e rate limit

Gli errori sono sempre JSON con i campi error, code, hint, docs e openapi. Un'azione sconosciuta risponde HTTP 400 con code UNKNOWN_ACTION, un percorso /api/ sconosciuto HTTP 404 con NOT_FOUND. Troppe richieste rispondono 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

File leggibili dalle macchine

Contatto tecnico

Domande su integrazione, rate limit o accesso in scrittura: e-mail servus@bergsonne-allgaeu.de o +49 8321 3360.