Mi API devuelve solo los primeros registros: cómo revisar la paginación
Una respuesta correcta puede contener solo una página del catálogo o de los contactos. Revisa continuación, orden y progreso antes de confiar en una importación aparentemente completa.
Si una importación obtiene siempre los primeros contactos o productos, comprueba si está leyendo una sola página de la API. Recibir un estado HTTP correcto no demuestra que hayas descargado todo el conjunto. También debes revisar filtros, permisos y la señal que indica cómo continuar.
Reconocer el contrato del endpoint
Busca en su documentación qué tamaño devuelve y cómo comunica la siguiente página. Puede usar números de página, desplazamiento, cursores o enlaces. No inventes parámetros a partir de otra API del mismo proveedor: distintos endpoints pueden tener contratos diferentes.
Como ejemplo concreto, la documentación REST de GitHub explica respuestas paginadas y el uso de cabeceras Link. No es una regla universal para cualquier API. La integración debe interpretar el mecanismo que realmente ofrece su origen.
Distinguir límite, filtro y permiso
Un resultado corto puede ser correcto si se aplica un filtro por fecha, estado o cuenta. Compara la consulta con lo que muestra el panel usando el mismo usuario y criterio. El número de filas visibles en una pantalla no es automáticamente el total accesible por API.
Registra consulta, cantidad recibida y referencia de continuación, sin guardar información personal innecesaria. Si hay un total anunciado por el proveedor, comprueba qué significa: podría referirse a otra selección o cambiar mientras lees.
Seguir la continuación hasta su final real
Diseña la lectura alrededor de la señal documentada de finalización. No pares siempre después de una petición ni concluyas que una página corta es la última sin comprobar el contrato.
Si la respuesta incluye enlaces, valida que pertenecen al servicio esperado antes de utilizarlos. No reenvíes credenciales a un dominio arbitrario por seguir una URL sin control. Conserva errores de autorización o de límite de peticiones como fallos, no como páginas vacías válidas.
Considerar cambios mientras recorres el conjunto
Si durante la importación aparecen o desaparecen elementos, una paginación basada en posiciones puede desplazar registros. Cuando la API lo permita, utiliza un orden estable y un punto de corte coherente, o mecanismos específicos de sincronización.
No prometas una instantánea consistente si el proveedor no la ofrece. Puede ser necesario conciliar después los cambios. La solución depende de si buscas una exportación puntual o una sincronización continua de pedidos, catálogo o contactos.
Guardar progreso sin duplicar efectos
Relaciona los registros con identificadores de origen y registra el avance después de confirmar su procesamiento. Si una ejecución se interrumpe, debe poder reanudarse sin crear una copia nueva de cada elemento ya importado.
Un cursor puede caducar o dejar de ser válido según la API. Define qué hacer en ese caso: volver a empezar con deduplicación, reconstruir una ventana o solicitar revisión. Guardar un cursor no garantiza por sí solo recuperación indefinida.
Probar con más datos que una sola página
La prueba mínima necesita superar el tamaño de página y contener un registro conocido al final del recorrido. Añade una interrupción intermedia y una actualización durante la lectura. Compara identificadores únicos y resultado de negocio, no solo número de peticiones.
Si tu integración trae parte del catálogo o pierde contactos, podemos revisar la conexión mediante API o desarrollar un proceso Python con progreso verificable. Corregir la paginación debe resolver integridad del recorrido, no únicamente aumentar el límite de una petición.