# Exploitation des horaires via API Rest

**URL:** <https://support.datatourisme.fr/t/exploitation-des-horaires-via-api-rest/2978>\
**Category:** API REST \[Betatest\]\
**Created:** [Novembre 14, 2025, 10:31 UTC](https://support.datatourisme.fr/t/exploitation-des-horaires-via-api-rest/2978 "2025-11-14T10:31:44Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![Timothee\_LASSUS](https://support.datatourisme.fr/letter_avatar_proxy/v4/letter/t/22d042/32.png) [@Timothee\_LASSUS](https://support.datatourisme.fr/u/Timothee_LASSUS)\
**Post date:** [Novembre 14, 2025, 10:31 UTC](https://support.datatourisme.fr/t/exploitation-des-horaires-via-api-rest/2978/1 "2025-11-14T10:31:44Z")

</div>

Bonjour,  
Je rencontre des difficultés pour la récupération des horaires via API Rest :

Le schéma POI présent dans la documentation semble ne pas correspondre à l’enveloppe json reçue : l’objet **openingHoursSpecification** est toujours dans **isLocatedAt** en passant par le _catalog/uuid_, **arrivedAt** cité par la doc semble ne pas encore exister.  
Aussi, aucun des deux n’est présent dans la réponse json en passant par _catalog?filters=identifier=995005239_.

Est-ce un soucis d’interrogation de mon côté, un bug, ou une évolution à venir ?

A disposition

---

<div class="post-metadata">

**Author:** ![conjecto](https://support.datatourisme.fr/user_avatar/support.datatourisme.fr/conjecto/32/8_2.png) [@conjecto](https://support.datatourisme.fr/u/conjecto)\
**Post date:** [Décembre 1, 2025, 6:19 UTC](https://support.datatourisme.fr/t/exploitation-des-horaires-via-api-rest/2978/2 "2025-12-01T18:19:42Z")

</div>

Bonjour,

Il s’agit d’une erreur de la documentation, `isLocatedAt`contient bien la propriété `openingHoursSpecification`. Vous pouvez le vérifier sur le swagger : [Swagger UI](https://api.datatourisme.fr/v1/swagger/)

Nous allons faire le nécessaire pour corriger la documentation. Sur le fait que `arrivedAt` ne soit pas renseigné, c’est possible : les producteurs n’ont peut être pas aligné cette propriété.

Cordialement

---

<div class="post-metadata">

**Author:** ![Jean-Francois\_TRICHA](https://support.datatourisme.fr/letter_avatar_proxy/v4/letter/j/f04885/32.png) [@Jean-Francois\_TRICHA](https://support.datatourisme.fr/u/Jean-Francois_TRICHA)\
**Post date:** [Décembre 1, 2025, 6:51 UTC](https://support.datatourisme.fr/t/exploitation-des-horaires-via-api-rest/2978/3 "2025-12-01T18:51:04Z")

</div>

Bonjour

arrivedAt est lieu d’arrivée d’un itinéraire, il accepte un Place

---

<div class="post-metadata">

**Author:** ![Timothee\_LASSUS](https://support.datatourisme.fr/letter_avatar_proxy/v4/letter/t/22d042/32.png) [@Timothee\_LASSUS](https://support.datatourisme.fr/u/Timothee_LASSUS)\
**Post date:** [Décembre 2, 2025, 3:56 UTC](https://support.datatourisme.fr/t/exploitation-des-horaires-via-api-rest/2978/4 "2025-12-02T15:56:30Z")

</div>

Merci pour votre retour sur la partie structure.  
La seconde partie de mon message portait sur l’enveloppe json du _catalog_ : l’objet _openingHoursSpecification_ semble absente de toutes les réponses, un exemple avec la requête ci-dessous qui pour autant a des horaires d’après votre flux de production :  
[https://api.datatourisme.fr/v1/catalog?filters=identifier=995005239](https://api.datatourisme.fr/v1/catalog?filters=identifier=995005239)

> **[La ressource demandée n'existe pas ! |DATAtourisme](https://data.datatourisme.fr/93236f1a-19eb-3f33-b072-fe55288b5c6a)**
>
> La plateforme nationale de collecte, d’homogénéisation et de diffusion en open data des données d’informations touristiques produites à travers les destinations. Un dispositif porté par l’Etat en partenariat avec l’ensemble des acteurs touristiques...

---

<div class="post-metadata">

**Author:** ![conjecto](https://support.datatourisme.fr/user_avatar/support.datatourisme.fr/conjecto/32/8_2.png) [@conjecto](https://support.datatourisme.fr/u/conjecto)\
**Post date:** [Décembre 3, 2025, 8:01 UTC](https://support.datatourisme.fr/t/exploitation-des-horaires-via-api-rest/2978/5 "2025-12-03T08:01:34Z")

</div>

Bonjour,

La documentation manque de clarté sur un point : par défaut, seule une sélection de champ est renvoyée par l’API. `openingHoursSpecification` ne fait pas partie de cette sélection, il faut demander explicitement le champs via le paramètre `fields` :

[https://api.datatourisme.fr/v1/catalog?fields=isLocatedAt.openingHoursSpecification&filters=identifier=995005239](https://api.datatourisme.fr/v1/catalog?fields=isLocatedAt.openingHoursSpecification&filters=identifier=995005239)

ou plus simplement :

[https://api.datatourisme.fr/v1/catalog?fields=isLocatedAt&filters=identifier=995005239](https://api.datatourisme.fr/v1/catalog?fields=isLocatedAt&filters=identifier=995005239)

Si vous avez besoin des autres champs, vous pouvez les lister dans le paramètre `fields`:

[https://api.datatourisme.fr/v1/catalog?fields=uuid,label,isLocatedAt&filters=identifier=995005239](https://api.datatourisme.fr/v1/catalog?fields=uuid,label,isLocatedAt&filters=identifier=995005239)

Cordialement

---

<div class="post-metadata">

**Author:** ![Timothee\_LASSUS](https://support.datatourisme.fr/letter_avatar_proxy/v4/letter/t/22d042/32.png) [@Timothee\_LASSUS](https://support.datatourisme.fr/u/Timothee_LASSUS)\
**Post date:** [Décembre 3, 2025, 8:42 UTC](https://support.datatourisme.fr/t/exploitation-des-horaires-via-api-rest/2978/6 "2025-12-03T08:42:09Z")

</div>

Parfait, merci pour votre retour.
