Deux pages de 100 lignes
Cas fictif : 200 lignes reçues mais 190 identifiants uniques. Les dix répétitions ne prouvent pas une erreur du fournisseur ; rechercher chevauchement ou mises à jour avant d’annoncer 200 objets.
Guides pratiques approfondis
Contrôler la pagination d’une API
Distinguer réponse réussie et collecte complète, suivre les curseurs et vérifier les identifiants récupérés.
Mise à jour :
Illustration générée par IA · Commutateur Ethernet et câbles réseau. Scène illustrative.
Avez-vous obtenu toutes les pages attendues ?
Une réponse 200 peut ne contenir que la première page. La pagination peut utiliser un numéro, un décalage, un curseur ou un lien suivant. Ce guide propose une recette de collecte reproductible ; le mécanisme exact reste celui de la documentation du service.
Fixer le périmètre
Conserver requête, filtres, version et ordre de tri. Relever le total annoncé et ce qu’il compte : lignes, résultats estimés ou objets distincts. Ne pas comparer un total filtré avec une collecte sans filtre.
Suivre le mécanisme annoncé
Lire le lien suivant ou le curseur fourni. Garder une trace de chaque transition et refuser une boucle déjà parcourue. Ne pas reconstruire une adresse au hasard quand le service fournit sa continuation.
Réconcilier les effectifs
Compter lignes reçues et identifiants uniques séparément. Des pages qui se chevauchent gonflent le premier nombre. Préserver les objets répétés pour diagnostiquer leur version avant toute déduplication.
Documenter l’arrêt
Noter fin annoncée, plafond de collecte, erreur ou interruption. Si les données changent pendant le parcours, utiliser un instantané lorsque disponible ou signaler cette limite. Reprendre avec les mêmes filtres.
Situations et arbitrages
Situations types pour préparer un contrôle. Elles ne décrivent pas des missions ou observations réalisées.
Le curseur revient au début
Exemple illustratif : une continuation déjà vue réapparaît. Arrêter et conserver la trace. Une boucle ne doit pas être interprétée comme une collecte exhaustive.
Preuve à conserver
- Requête, filtres et version
- Transitions et réponses par page
- Effectifs bruts et uniques
- Motif d’arrêt et reprise possible
Références officielles
Fiches de sources associées
Protocoles connexes
Points à vérifier avant de conclure
- Les filtres sont-ils stables ?
- Les curseurs sont-ils uniques ?
- Les répétitions sont-elles expliquées ?
- Le motif d’arrêt est-il explicite ?
Un journal de collecte distinguant réussite technique, couverture observée et collecte interrompue.
Questions fréquentes
Une dernière page courte suffit-elle ?
Seulement si le contrat du service le prévoit. Une page courte peut aussi venir d’un filtre ou d’un changement de données. Utilisez le signal de fin documenté.
Pourquoi garder les lignes répétées ?
Elles permettent de repérer chevauchements et changements de version. Les supprimer immédiatement masque la cause et peut faire perdre une observation utile.
OUTILS / REGISTRES
Rédiger un relevé
Un total peut être estimé ou varier pendant la collecte. La présence d’un lien suivant n’autorise pas à ignorer les quotas, les conditions d’accès ou les limites documentées.
- Date de consultation et fuseau
- URL exacte
- Statut HTTP / redirection
- Continuation / curseur reçu
- Nombre de lignes reçues
- Identifiants distincts reçus
- Version / révision
- Limite / incertitude
- Décision / prochaine action
- Responsable du contrôle
- Prochain contrôle