Pagination et tri

Les endpoints LIST de l'API NOÉ supportent des paramètres de tri et de pagination pour gérer efficacement de grandes collections d’entités.

📋 Paramètres principaux

Paramètre	Type	Description	Exemple
sort	Instructions de tri séparés par une virgule	Définir l’ordre de tri des résultats	sort=-createdAt,+name
limit	Nombre	Nombre maximal de résultats retournés	limit=10
skip	Nombre	Décalage des résultats pour la pagination (offset)	skip=20

info

Les paramètres sort, limit et skip sont toujours appliqués après filtrage.

---

🔧 Détail des paramètres

Sort

Permet de trier les résultats selon un ou plusieurs champs.

• Préfixe + → tri croissant (ascendant)
• Préfixe - → tri décroissant (descendant)
• Plusieurs champs : séparer par une virgule ,

# Tri par date de création croissante, puis par nom décroissant
GET /projects/:projectId/activities?sort=+createdAt,-name

Limit

Limite le nombre de documents retournés par la requête. Permet de contrôler la charge sur le serveur et d’implémenter des pages.

# Retourne les 10 premiers résultats
GET /projects/:projectId/activities?limit=10

Skip

Permet de sauter un nombre de résultats pour implémenter la pagination. Souvent utilisé en combinaison avec limit.

# Retourne 10 résultats à partir du 21ème résultat
GET /projects/:projectId/activities?limit=10&skip=20

📦 Combinaison avec les filtres

Tous les paramètres de pagination et de tri peuvent être combinés avec les filtres définis via filter:

GET /projects/:projectId/activities?
 filter[tags][$in]=musique,art
 &sort=+createdAt,-name
 &limit=10
 &skip=20

• Filtre : les activités avec les tags "musique" ou "art"
• Tri : d’abord par date de création croissante, puis par nom décroissant
• Pagination : page 3 (éléments 21 à 30)