Una resposta de l’API pot no contenir totes les dades
Una automatització exporta una llista i acaba sense errors. El fitxer s’obre, les columnes encaixen i tot sembla correcte. Però això no demostra que hi siguin tots els registres: potser només s’ha llegit la primera pàgina de l’API.
Una pàgina no és tota la col·lecció
Molts serveis retornen les dades en lots per limitar la mida de cada resposta. Microsoft Graph, per exemple, pot paginar des del servidor sense que l’aplicació ho demani. La documentació explica que la resposta inclou @odata.nextLink quan hi ha una pàgina següent.
En aquest servei cal seguir l’URL completa retornada fins que ja no aparegui l’enllaç següent. No convé extreure’n un tros i reconstruir-lo: pot contenir informació necessària per continuar la mateixa consulta. Altres APIs utilitzen cursors o mecanismes diferents; consulta el contracte de l’endpoint concret.
Comprova què vol dir complet
Abans de connectar el resultat a un informe, defineix quina col·lecció vols obtenir, amb quins filtres i permisos. Llegir totes les pàgines d’una consulta no dona accés a dades que el compte no pot veure ni corregeix un filtre equivocat.
Registra les pàgines llegides, els elements rebuts i el punt en què s’ha acabat el recorregut. Si el servei ofereix un total, comprova què compta i amb quin abast abans de comparar-lo. En Graph, una pàgina pot contenir zero elements i encara cal interpretar l’estat de paginació.
Prova el cas que no cap a la primera pàgina
Un conjunt petit pot amagar l’error durant les proves. Utilitza dades de prova autoritzades que superin la mida d’una pàgina i comprova identificadors del principi i del final. Inclou també una interrupció a mig recorregut: el procés no hauria de presentar el resultat parcial com una exportació acabada.
Si la consulta falla, conserva el progrés i el motiu de l’aturada sense exposar enllaços de continuació en registres públics. Defineix com reprendre-la segons les regles del proveïdor. L’objectiu no és obtenir un fitxer que sembli complet, sinó poder explicar per què el recorregut ha acabat i quines dades cobreix.