[ANNONCE] Abaissement du nombre maximum d'objets lors des appels à l'API

API API REST [Betatest]
1

Bonjour à toutes et à tous,

Le nombre maximum d’objets renvoyés par page par l’API DATAtourisme passe de 250 à 100. Cette limite porte sur le paramètre page_size.

Pourquoi ce changement ?

Les pages très volumineuses chargent fortement l’infrastructure de l’API, et ce pour tous les utilisateurs. Avec des pages plus petites, les temps de réponse restent courts et le service stable pour tout le monde.

Ce qui change pour vous

  • page_size accepte désormais une valeur comprise entre 1 et 100. La valeur par défaut reste 20.

  • Si votre intégration demande plus de 100 objets par page (par exemple page_size=250), adaptez-la dès maintenant.

Comment adapter votre intégration ?

  1. Réglez page_size à 100 au maximum dans vos appels.

  2. Parcourez les résultats avec les liens next / previous de l’objet meta, ou avec l’en-tête HTTP Link. Cette méthode est la plus fiable pour récupérer tout le catalogue sans rien manquer.

  3. Ne calculez pas vous-même le nombre de pages à partir de la valeur que vous avez demandée. Fiez-vous à meta.page_size et meta.total_pages renvoyés dans la réponse.

  4. Rappel : l’accès direct par numéro de page (page=N) s’arrête aux 10 000 premiers résultats, soit 100 pages de 100 objets. Au-delà, suivez les liens next.

La documentation est à jour : Documentation API DATAtourisme

Cordialement.

3

Bonjour, Merci pour l’information. J’ai adapté mon intégration en passant page_size à 100 comme recommandé. Mon application Android utilise vos données (événements + POI) et fonctionne très bien avec cette modification. Pour ceux que ça intéresse, elle est disponible sur Google Play : Évènementiel Alerte. Bonne journée.