{"openapi":"3.1.0","info":{"title":"Stayflex — API agents","version":"1.1.0","summary":"Recherche de chambres d'hôtel en day-use (à l'heure) près de Paris-CDG.","description":"API publique en lecture seule, pensée pour les assistants. Disponibilité et prix proviennent des mêmes fonctions que le tunnel de réservation : le montant annoncé est celui qui sera facturé. Chaque hôtel vend des durées fixes (paliers, ex. 3 h, 6 h ou 10 h) : une durée demandée qui n'en est pas une est arrondie au palier immédiatement supérieur, et tout le résultat porte sur ce palier. Cette API ne prend aucun paiement — elle renvoie un lien de réservation où un humain confirme et paie. Éditée par NERLUNA SAS (RCS Paris 999 531 460).","termsOfService":"https://stayflexhotel.com/fr/terms","contact":{"name":"Stayflex","email":"contact@stayflexhotel.com","url":"https://stayflexhotel.com"}},"externalDocs":{"description":"Guide pour les agents et les assistants (llms.txt)","url":"https://stayflexhotel.com/llms.txt"},"servers":[{"url":"https://stayflexhotel.com/api/agent/v1","description":"Production"}],"paths":{"/day-use/search":{"get":{"operationId":"searchDayUse","summary":"Chercher des chambres disponibles en day-use","description":"Renvoie les hôtels ayant au moins une chambre libre sur le créneau demandé, avec le prix ferme de chaque chambre. Les chambres sans tarif day-use configuré sont exclues plutôt que renvoyées à 0 €. La durée appliquée est un palier de l'hôtel (`durationHoursApplied`) : le plus court qui couvre `durationHours`. Un hôtel sans palier assez long, ou dont le palier ne tient pas avant 22:00, est écarté et une phrase de `notes` dit pourquoi.","parameters":[{"name":"airport","in":"query","description":"Code de zone aéroportuaire. Seul `CDG` est desservi aujourd'hui.","schema":{"type":"string","enum":["CDG"]}},{"name":"city","in":"query","description":"Commune exacte, si l'on ne passe pas par `airport`.","schema":{"type":"string"}},{"name":"date","in":"query","required":true,"description":"Jour d'arrivée, AAAA-MM-JJ.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"checkIn","in":"query","description":"Heure d'arrivée HH:MM, heure de Paris. Défaut 10:00. Le day use se réserve de 08:30 à 22:00 : arrivée entre 08:30 et 22:00 moins la durée, par pas de 30 min (08:30, 09:00, 09:30…), au moins 30 min à l'avance et pas plus tôt que le délai minimum de réservation de l'hôtel. Hors de ces règles : 400, avec dans `hint` la plage ou la première arrivée possible.","schema":{"type":"string","pattern":"^\\d{2}:\\d{2}$","default":"10:00"}},{"name":"durationHours","in":"query","description":"Durée souhaitée en heures. Chaque hôtel vend des paliers fixes (voir `availableDurations`) : si la durée n'en est pas un, le palier immédiatement supérieur est appliqué et renvoyé dans `durationHoursApplied`. Défaut 2 : le palier le plus court de chaque hôtel.","schema":{"type":"integer","minimum":1,"maximum":12,"default":2}},{"name":"guests","in":"query","description":"Nombre de personnes. Les chambres trop petites sont écartées.","schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Résultats de recherche","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"description":"Paramètre manquant ou invalide, ou créneau non réservable (hors 08:30-22:00, hors pas de 30 min, passé, trop proche, sous le délai minimum de l'hôtel). Le corps porte `error` et, pour un créneau, un `hint` qui donne la plage ou la première arrivée possible.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"hint":{"type":"string"}}}}}}}}}},"components":{"schemas":{"SearchResponse":{"type":"object","required":["query","currency","priceValidUntil","results"],"properties":{"query":{"type":"object","description":"Rappel de la demande : `durationHours` et `checkOut` sont ceux DEMANDÉS ; la durée et la fin réellement appliquées sont propres à chaque hôtel (`durationHoursApplied`, `checkOut` du résultat)."},"currency":{"type":"string","const":"EUR"},"priceIncludesTax":{"type":"boolean","description":"Les prix sont TTC."},"priceValidUntil":{"type":"string","format":"date-time","description":"Au-delà de cette date, refaire la recherche : les stocks bougent."},"hotelsConsidered":{"type":"integer","description":"Hôtels examinés — aucun plafond silencieux."},"hotelsWithAvailability":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/HotelResult"}},"notes":{"type":"array","items":{"type":"string"},"description":"Règles de lecture, puis une phrase par hôtel écarté et la raison."}}},"HotelResult":{"type":"object","required":["hotelId","name","fromPrice","rooms","bookingUrl","durationHoursApplied","availableDurations"],"properties":{"hotelId":{"type":"string"},"name":{"type":"string"},"slug":{"type":["string","null"]},"city":{"type":["string","null"]},"address":{"type":["string","null"]},"coordinates":{"type":["object","null"],"properties":{"lat":{"type":"number"},"lng":{"type":"number"}}},"category":{"type":["string","null"],"description":"Classement tel que saisi (« 4 », « palace ») ; préférer `stars`."},"stars":{"type":["integer","null"],"description":"Nombre d'étoiles (un palace compte 5)."},"rating":{"type":["number","null"],"description":"Note moyenne des avis ; null tant que l'hôtel n'a aucun avis."},"reviewCount":{"type":["integer","null"],"description":"Nombre d'avis ; null s'il n'y en a aucun."},"fromPrice":{"type":"number","description":"Prix total de la chambre libre la moins chère, TTC, pour la durée appliquée."},"durationHoursApplied":{"type":"integer","description":"Durée réellement vendue, en heures : le plus court palier de l'hôtel couvrant `durationHours`. Prix, disponibilité, `checkOut` et `bookingUrl` portent sur elle."},"checkOut":{"type":"string","format":"date-time","description":"Fin du créneau, pour la durée appliquée."},"availableDurations":{"type":"array","description":"Paliers que l'hôtel vend ce jour-là, par durée croissante, avec le prix « dès » TTC de chacun (la chambre la moins chère adaptée au nombre de personnes). Seul le palier appliqué a sa disponibilité vérifiée.","items":{"type":"object","required":["hours","fromPrice"],"properties":{"hours":{"type":"integer"},"fromPrice":{"type":"number"}}}},"rooms":{"type":"array","items":{"$ref":"#/components/schemas/RoomOffer"}},"bookingUrl":{"type":"string","format":"uri","description":"Page où un humain confirme et paie. L'agent ne paie pas. Le lien porte déjà le créneau (date, heure d'arrivée, durée appliquée, nombre de personnes) : le client n'a rien à re-saisir, il choisit sa chambre et confirme. Donne ce lien tel quel, sans en retirer de paramètre."},"hotelUrl":{"type":"string","format":"uri"}}},"RoomOffer":{"type":"object","required":["roomTypeId","name","roomsAvailable","totalPrice"],"properties":{"roomTypeId":{"type":"string"},"name":{"type":"string"},"nameEn":{"type":["string","null"]},"maxGuests":{"type":["integer","null"]},"roomsAvailable":{"type":"integer","description":"Chambres réellement libres sur ce créneau."},"totalPrice":{"type":"number","description":"Prix total TTC pour la durée appliquée (`durationHoursApplied`)."},"pricePerHour":{"type":"number"},"pricingBasis":{"type":"string","enum":["period","flat_hourly"],"description":"`period` = tarif saisonnier configuré ; `flat_hourly` = tarif horaire de base."},"periodName":{"type":["string","null"]}}}}}}