Portail Développeurs Hotel Bergsonne Allgäu — API de réservation, MCP & OpenAPI

Cette page est le point d'entrée pour les agents IA, chatbots et partenaires d'intégration. Tous les points de lecture sont publics et sans authentification; les réservations passent par un chemin d'écriture documenté.

Quand utiliser cette API

Interroger la disponibilité et les tarifs en direct pour des dates précises à Sonthofen, Allgäu.
Décrire les types de chambres, l'occupation, les équipements, l'accessibilité et la chambre de soins.
Répondre sur les horaires d'arrivée, les contacts et les faits de l'établissement.
Lancer une réservation directe ou transférer l'hôte vers le parcours de réservation.

Quand ne pas utiliser cette API

Pour d'autres hôtels ou une recherche multi-établissements: cette API ne décrit que le Hotel Bergsonne Allgäu.
Pour annuler ou modifier une réservation existante: par e-mail ou téléphone.
Pour le traitement des paiements, les données des hôtes ou les systèmes internes.
Pour des requêtes en masse sans intention de voyage: une limite de débit s'applique.

Démarrage rapide

Trois étapes: lire les données de l'établissement, vérifier la disponibilité, confirmer le prix. Paramètres insensibles à la casse, prix en EUR TTC.

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

Authentification

La lecture est ouverte: hotel, fact-sheet, availability, price-quote, addons et discover-rooms ne nécessitent aucun jeton. L'écriture (action=bookings) utilise POST; détails OAuth 2.1 dans /.well-known/oauth-protected-resource et /.well-known/auth.md.

Scopes & moindre privilège

Les scopes OAuth nommés sont déclarés de façon lisible par machine: scopes_supported dans /.well-known/oauth-protected-resource (RFC 9728) et schéma de sécurité OAuth dans /api/openapi. Les agents ne demandent que le scope minimal.

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

Auto-inscription sans formulaire ni validation humaine: POST /agent/auth renvoie un credential bearer anonyme avec hotel:read et booking:read. booking:write passe par le flux OAuth avec PKCE (S256), car la réservation est faite au nom d'un client identifié.

Sandbox & idempotence

Avec "test": true dans le corps de réservation, la requête s'exécute en mode sandbox: validation et tarification identiques, aucune réservation réelle, réponse avec un bookingId TEST. Une "idempotencyKey" par tentative évite les doublons.

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
}

Erreurs & limites de débit

Les erreurs sont toujours en JSON avec les champs error, code, hint, docs et openapi. Une action inconnue renvoie HTTP 400 et le code UNKNOWN_ACTION, un chemin /api/ inconnu HTTP 404 et NOT_FOUND. Un débit excessif renvoie HTTP 429 et RATE_LIMITED.

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

Fichiers lisibles par machine

Contact technique

Questions sur l'intégration, les limites de débit ou un accès en écriture: e-mail servus@bergsonne-allgaeu.de ou +49 8321 3360.