Pagination et limites d'utilisation

Principe de fonctionnement

L'API de La Vitrine implémente un système de pagination pour toutes les requêtes de données. Cette approche permet d'optimiser les performances en limitant le volume de données transférées par requête et offre une navigation fluide à travers de grands ensembles de résultats. Par défaut, les réponses sont limitées à 10 éléments par page, mais ce paramètre est personnalisable. La pagination est essentielle pour gérer efficacement les collections volumineuses d'événements, de lieux culturels ou de contributeurs.

Paramètres de pagination

Deux paramètres principaux vous permettent de contrôler la pagination de vos requêtes :

• page : Indique la page de résultats souhaitée (la numérotation commence à 1)

• limit : Définit le nombre maximum d'éléments par page (valeur maximale autorisée : 100)

Exemple d'utilisation : /events?page=2&limit=20

Structure de la réponse

Chaque réponse paginée inclut une section pagination contenant les métadonnées suivantes :

• total : Nombre total d'éléments correspondant à la requête

• page : Page actuelle

• limit : Nombre d'éléments par page

• totalPages : Nombre total de pages disponibles

• nextPageUrl : URL complète pour accéder à la page suivante (absent sur la dernière page)

Cette structure facilite l'implémentation de la navigation entre les pages et permet d'informer les utilisateurs sur la quantité totale de données disponibles.