Hotel Bergsonne Allgäu Developer Portal — Booking API, MCP & OpenAPI

Deze pagina is het startpunt voor AI-agents, chatbots en integratiepartners. Alle lees-endpoints zijn openbaar en vereisen geen authenticatie; boekingen lopen via een gedocumenteerd schrijfpad.

Wanneer je deze API gebruikt

Live beschikbaarheid en tarieven opvragen voor concrete reisdata in Sonthofen, Allgäu.
Kamertypes, bezetting, voorzieningen, toegankelijkheid en zorgkamerdetails beschrijven.
Check-in-tijden, contactgegevens en huisfeiten beantwoorden.
Een directe boeking starten of de gast doorsturen naar het boekingsproces.

Wanneer deze API niet past

Voor andere hotels of zoeken over meerdere locaties: deze API beschrijft alleen Hotel Bergsonne Allgäu.
Voor het annuleren of wijzigen van bestaande boekingen: gebruik e-mail of telefoon.
Voor betalingsverwerking, gastgegevens of interne systemen.
Voor bulkopvragingen zonder reisintentie: er geldt een rate limit.

Quickstart

Drie stappen: hotelgegevens lezen, beschikbaarheid checken, prijs bevestigen. Alle parameters zijn case-insensitive, alle prijzen in EUR inclusief btw.

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

Authenticatie

Lezen is open: hotel, fact-sheet, availability, price-quote, addons en discover-rooms vereisen geen token. Schrijven (action=bookings) gebeurt via POST; OAuth 2.1 staat in /.well-known/oauth-protected-resource en /.well-known/auth.md.

Scopes & least privilege

Benoemde OAuth-scopes zijn machineleesbaar vastgelegd: als scopes_supported in /.well-known/oauth-protected-resource (RFC 9728) en als OAuth-securityscheme in /api/openapi. Agents vragen alleen de kleinst nodige scope aan.

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

Zelfregistratie zonder formulier of menselijke goedkeuring: POST /agent/auth geeft een anoniem bearer-credential met hotel:read en booking:read. booking:write gebruikt de OAuth-flow met PKCE (S256), omdat een reservering op naam van een gast staat.

Sandbox & idempotentie

Met "test": true in de boekingsbody loopt het verzoek in sandboxmodus: validatie en prijsberekening zijn identiek, er ontstaat geen echte reservering en het antwoord bevat een TEST-bookingId. Een "idempotencyKey" per poging voorkomt dubbele boekingen.

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
}

Fouten & rate limits

Fouten komen altijd als JSON met de velden error, code, hint, docs en openapi. Onbekende acties geven HTTP 400 met code UNKNOWN_ACTION, onbekende /api/-paden HTTP 404 met code NOT_FOUND. Te veel verzoeken geven HTTP 429 met code RATE_LIMITED.

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

Machineleesbare bestanden

Technisch contact

Vragen over integratie, rate limits of schrijftoegang: mail servus@bergsonne-allgaeu.de of bel +49 8321 3360.