Una exportación que lee solo la primera respuesta puede parecer correcta si nadie compara el total. Registra el avance de la paginación y comprueba los identificadores al final.
Lee los metadatos
Usa el mecanismo de paginación de la versión del endpoint que consultes. Guarda el número de página o cursor, la cantidad recibida y el total indicado cuando exista. Trabaja con una clave de solo lectura.
Guarda los identificadores
Añade cada página a la exportación y conserva los IDs de producto para identificar solapamientos. Si el catálogo cambia durante el proceso, usa una ventana estable o registra la hora de corte y reconcilia los cambios.
Comprueba los bordes
Prueba primero con un límite pequeño y un catálogo de más de dos páginas. Contrasta número de IDs únicos y total esperado, y verifica que se han incluido el primer y el último producto del conjunto.
Una prueba que descubre el fallo antes del catálogo entero
Crea un catálogo de pruebas con cinco productos y fija un límite de dos por página. Deben llegar dos productos en la primera respuesta, dos en la segunda y uno en la tercera. Conserva los IDs. Si el cliente repite una página y confías en el número de filas, el recuento bruto puede engañarte.
Para la API de catálogo de BigCommerce, una petición de lectura de ejemplo utiliza el código de tienda y un token de solo lectura. Mantén el valor del token en una variable del entorno de pruebas.
curl -fsS \
-H "X-Auth-Token: ${BIGCOMMERCE_TOKEN}" \
-H 'Accept: application/json' \
'https://api.bigcommerce.com/stores/CODIGO_TIENDA/v3/catalog/products?limit=2&page=1'Lee data y los metadatos de paginación de la respuesta. Guarda temporalmente cada página por separado hasta que la ejecución termine. Registra página, número de elementos y respuesta HTTP. Si hay un error o faltan IDs esperados, conserva el estado para reintentar sin sobrescribir el archivo completo.
Una comprobación mínima compara el total anunciado, el número de IDs únicos y la lista de duplicados. Si el catálogo cambia mientras exportas, el número anunciado es una observación de un momento. Para que la revisión sea reproducible, usa una ventana estable o registra los cambios del intervalo y reconcilia al terminar.

