Division d'une grande réponse d'API en pages numérotées afin que les données soient retournées en morceaux gérables plutôt que toutes en même temps.
Lorsqu'un point d'extrémité d'API pourrait retourner des milliers ou des millions d'enregistrements, les retourner tous en une seule réponse serait lent et gourmand en ressources. La pagination divise la réponse en pages. Le client demande la page 1, obtient les 100 premiers enregistrements; demande la page 2, obtient les 100 suivants; et ainsi de suite jusqu'à ce que tous les enregistrements aient été récupérés.
Les approches courantes de pagination comprennent la pagination par page (spécifier le numéro de page et la taille de page), par décalage (spécifier combien d'enregistrements ignorer) et par curseur (utiliser un jeton de la réponse précédente pour obtenir la page suivante).
Exemple : Un développeur interroge une API de données ouvertes pour tous les permis de construction d'une ville. L'API retourne 100 enregistrements par page. La première réponse comprend les enregistrements 1 à 100 et un lien vers la page suivante. Le script du développeur suit les liens de page suivante jusqu'à ce qu'aucune autre page ne soit retournée, collectant tous les permis sur plusieurs requêtes.