Aller au contenu

Pagination

Les listes se paginent par curseur : pas de numéro de page ni de total, mais un jeton opaque vers la page suivante.

Fenêtre de terminal
curl "$IDALGO_API/v1/contests?season=374703&limit=50"
{
"data": ["…50 contests…"],
"meta": { "cursor": "eyJ…", "generatedAt": "…", "version": "v1", "lang": "fr" },
"links": {
"self": "/v1/contests?limit=50&season=374703",
"next": "/v1/contests?cursor=eyJ…&limit=50&season=374703"
}
}
  • limit : taille de page, 20 par défaut, 100 au plus ;
  • meta.cursor : à renvoyer en ?cursor= pour la page suivante, null sur la dernière ;
  • links.next : la page suivante prête à appeler, absente sur la dernière.

Gardez les mêmes filtres d’une page à l’autre ; un curseur invalide renvoie une erreur 400.

La recherche par nom (/v1/search) fait exception : elle renvoie ses meilleurs résultats en une seule fois, sans curseur, et limit en borne le nombre (10 par défaut, 50 au plus).

async function fetchAll(path) {
const items = [];
let next = path;
while (next) {
const page = await fetch(`${IDALGO_API}${next}`).then((response) => response.json());
items.push(...page.data);
next = page.links.next;
}
return items;
}