[API Lecture] Dates d’ouvertures : retour d’un nœud global comme en export XML

Contexte

Les exports XML incluaient déjà un nœud datesOuverture listant toutes les dates concrètes d’ouverture, calculées à partir des périodes et règles saisies.
Ce n’était pas le cas jusqu’ici dans les API de lecture, ce qui compliquait l’affichage des dates filtrées.

Évolution livrée

Depuis le 28 juillet 2025, les API suivantes retournent désormais le nœud datesOuverture :

• /v002/objet-touristique/get-by-id/

• /v002/recherche/list-objets-touristiques

• /v002/recherche/list-id-objets-touristiques

Comportement

• Les dates sont limitées à 2 ans dans le futur, comme en export.

• Elles sont triées chronologiquement.

• Le paramètre dateFin est désormais pris en compte dans les appels d’API get-by-id, ce qui permet de restreindre les dates retournées à une période définie.

• Plus aucune limite de 60 dates n’est appliquée (levée pour permettre une lecture complète).

Exemples d’appel :

/v002/objet-touristique/get-by-id/123456?responseFields=datesOuverture&dateFin=2026-07-01

Configuration nécessaire

Pour bénéficier de ce nœud datesOuverture, il faut cocher l’option “Exporter les dates d’ouverture” dans la configuration technique du projet numérique.

Cas d’usage

• Afficher uniquement les dates correspondant à une période recherchée dans un site ou une application.

• Éviter d’afficher des dates hors périmètre (ex : avant ou après le séjour sélectionné par l’utilisateur).

• Simplifier l'intégration sans devoir recalculer côté front les jours d’ouverture à partir des règles de récurrence.