Données de disponibilités

Vérifier un séjour

GET /api/v1/availability

Paramètres obligatoires : arrival et departure au format AAAA-MM-JJ. De 1 à 31 nuits, dans les 18 prochains mois.

Chercher par mois

GET /api/v1/stays

month au format AAAA-MM (mois courant par défaut), nights de 1 à 31 (7 par défaut). La durée est exacte. Les séjours peuvent finir le mois suivant.

Composition du groupe

property : all (par défaut), avel-heol ou avel-glaz. adults : 1–4 (2 par défaut), children : 0–3, babies : 0–2 (0 par défaut). Maximum total : quatre personnes, bébés compris par prudence ; au-delà, contacter Nathalie. Animaux non admis selon les fiches Clévacances consultées.

Interpréter les réponses

• offers_returned : lire chaque séjour et ses conditions ; aucune date bloquée.
• no_offer_returned : aucune offre pour ces paramètres ; ne pas conclure que le bien est occupé.
• unknown ou HTTP 503 : vérification indisponible. Ne pas réutiliser une ancienne disponibilité.
• Pour chaque séjour, requires_confirmation indique une confirmation ou des conditions à vérifier. Lire on_request, constraints et owner_confirmation_required.

Chaque logement porte checked_at et expires_at en UTC. Cache maximal : 300 secondes. Les heures de séjour utilisent le fuseau Europe/Paris. Les prix et conditions financières sont volontairement absents ; vérifier dans Clévacances via booking_url. L’API ne crée ni panier ni réservation.

Accès et limites

Sans clé ni connexion. Limite de 60 requêtes par minute et par adresse IP ; HTTP 429 et Retry-After au-delà. Budget global de 30 lectures Clévacances par minute : HTTP 503 lorsque la vérification n’est pas possible. HTTP 400 pour une recherche invalide.

La source est l’API du widget Clévacances. Sa disponibilité et sa synchronisation avec les autres plateformes ne sont pas garanties. Aucun code interne, compte propriétaire ou renseignement voyageur n’est publié.

Spécification OpenAPI · Point d’entrée texte pour les assistants