Pagination REST API
Définition : La pagination REST WordPress divise les collections de résultats en pages pour limiter la quantité de données transférées. Elle utilise notamment page, per_page et des en-têtes indiquant les totaux disponibles.
Comprendre et utiliser
À quoi sert cette notion ?
Elle réduit les réponses trop volumineuses et permet au client d’afficher progressivement un catalogue, une liste d’articles ou des résultats de recherche.
Fonctionnement technique
Les collections du Core acceptent généralement page et per_page ; le serveur peut fournir X-WP-Total et X-WP-TotalPages. Les bornes et paramètres dépendent de l’endpoint.
Dans quel contexte l’utiliser ?
Un catalogue ATOOLPHA affiche dix ressources par page sans charger l’ensemble des articles à chaque interaction.
Étude de cas : application professionnelle
Un catalogue de plusieurs centaines d’articles ne devrait pas être téléchargé en une seule réponse. Commencer avec une taille de page modérée et lire les en-têtes X-WP-Total et X-WP-TotalPages. Vérifier ce qui se produit lorsqu’un nouvel article est ajouté pendant la navigation. Le client doit savoir gérer une page devenue vide ou le changement d’ordre des résultats. Pour des synchronisations complexes, une pagination par numéro de page peut nécessiter une stratégie complémentaire. Une interface de consultation simple, en revanche, gagne immédiatement en lisibilité et en temps de chargement.
Exemple technique commenté
Les lignes ci-dessus sont des exemples de requêtes HTTP, non des commandes prêtes à coller dans un article. Pour les essayer, utiliser un client HTTP et un site de test. Toute opération d'écriture nécessite un compte autorisé, une authentification appropriée et une sauvegarde du jeu de données concerné.
GET /wp-json/wp/v2/posts?per_page=10&page=2
Accept: application/jsonDécryptage du code et résultat attendu
La requête demande la deuxième page de dix publications. Le client peut lire les en-têtes de total pour construire une navigation adaptée.
Exercice guidé pour vérifier la notion
Charger trois pages sur un WordPress de test et vérifier absence de doublons apparents, nombre total et dernier numéro disponible.
Précautions et limites
Ne pas présumer que les pages restent immuables si de nouvelles publications arrivent. Éviter les tailles excessives et prévoir le cas d’une page devenue vide.
À ne pas confondre
La pagination découpe les résultats ; les filtres sélectionnent les résultats et _fields réduit les propriétés de chaque objet.
Diagnostic avancé
Si la page demandée déclenche une erreur, vérifier X-WP-TotalPages et contrôler la variation du catalogue pendant la consultation.
Choix d’architecture et déploiement
Pour un outil appelé fréquemment, définir une taille de page modérée, suivre les liens et éviter les boucles de chargement sans borne.
