Controlar la paginación de una API

¿Se obtuvieron todas las páginas previstas?

Una respuesta 200 puede contener solo la primera página. Hay paginación por número, desplazamiento, cursor o enlace siguiente. Esta receta permite reproducir el control; el mecanismo exacto depende del servicio.

1. Fijar el alcance

   Guardar consulta, filtros, versión y orden. Aclarar si el total cuenta registros, estimaciones u objetos distintos. Comparar filtros equivalentes.

2. Seguir la continuación

   Leer el enlace o cursor recibido. Registrar transiciones y detectar repeticiones. No inventar direcciones si el servicio proporciona su continuación.

3. Conciliar recuentos

   Contar registros e identificadores únicos por separado. Las páginas solapadas aumentan el total bruto. Conservar repeticiones para revisar versiones antes de deduplicar.

4. Documentar la parada

   Anotar fin declarado, límite, error o interrupción. Usar una instantánea si existe o indicar que los datos cambian. Reanudar con los mismos filtros.

Situaciones y decisiones

Situaciones tipo para preparar un control. No describen misiones realizadas ni observaciones reales.

Prueba que conservar

• Consulta, filtros y versión
• Transiciones y respuestas
• Recuentos brutos y únicos
• Motivo de parada y condiciones de reanudación

Referencias oficiales

• GitHub — REST pagination
• IETF — Web Linking, RFC 8288

Fichas de fuentes relacionadas

• data.gouv.fr
• Eurostat · Data Browser
• Crossref Metadata Search
• Companies House

Protocolos relacionados

• Consultar una API pública y conservar una extracción verificable
• Conservar una versión reproducible de datos públicos
• Comprobar una unión antes de cruzar dos archivos

Comprobaciones antes de concluir

• ¿Son estables los filtros?
• ¿Las continuaciones son distintas?
• ¿Se explican las repeticiones?
• ¿Se indica el motivo de parada?

Un registro que distingue éxito técnico, cobertura observada y recopilación interrumpida.