Paginación a través de llamadas HTTP

El siguiente tutorial demuestra cómo utilizar la actividad Hacer mientras para gestionar la paginación de la API haciendo llamadas HTTP repetidas hasta que se recuperen todos los datos.

Los indicadores de paginación, como cursores, marcadores de final de página o límites, suelen incluirse en los encabezados de respuesta, el cuerpo de respuesta o como parámetros de consulta.

Este ejemplo recupera una lista de cervecerías utilizando la API OpenBreweryDB . De acuerdo con la especificación de la API de OpenBreweryDB, la paginación se gestiona utilizando parámetros basados en el desplazamiento (basados en la página). Para paginar el conjunto de datos, incluye per_page=X&page=Y como parámetros de consulta en la solicitud HTTP.

1. Crea un flujo de trabajo de API.
2. Añade una actividad HTTP y configúrala de la siguiente manera:
   • Método—GET
   • Solicitar URL :

     https://api.openbrewerydb.org/v1/breweries?per_page=10&page=1

3. Depura tu flujo de trabajo de la API para recuperar el primer listado de cervecerías.
4. Añade una actividad de Script y proporciona el siguiente código:

   const url = new URL($input.request.url);
   const currentPage = Number(url.searchParams.get("page"));
   
   return { nextPage: currentPage + 1, 
   content: $input.content}

   El uso de $input en lugar de $context garantiza que siempre hagas referencia a la salida de la última actividad ejecutada, especialmente dentro de un bloque de bucle. El código JavaScript devuelve un objeto JSON con nextPage y propiedades de contenido . Estas propiedades te permiten controlar el bucle, por ejemplo: continuar mientras nextPage < 10 o el contenido no sea nulo.
5. Añade una actividad Bucle > Hacer mientras encima de la actividad HTTP existente.
   1. Mueve las actividades HTTP y Script dentro del cuerpo de la actividad Hacer Mientras .
   2. Establece la Condición para la actividad Hacer mientras en $input.nextPage < 5.
   3. Para la actividad HTTP , abre el editor de expresiones de la propiedad Solicitar URL y actualiza la expresión a:

      "https://api.openbrewerydb.org/v1/breweries?per_page=10&page=" + ($input.nextPage == null ? 1 : $input.nextPage)

6. Depura tu flujo de trabajo de nuevo y observa la matriz de resultados en la pestaña Salida del panel Ejecutar salida .
7. Fuera de la actividad Hacer mientras , añade una actividad Respuesta y configúrala de la siguiente manera:
   • Tipo : Correcto
   • Detalles : abre el editor de expresiones y escribe lo siguiente:

     $context.outputs.Do_While_1.results.flatMap(result => result.content.map(brewery => brewery.name))

   Esto resume la respuesta en el paso 6 y enumera solo los nombres de las cervecerías.
8. Copia el resultado de la pestaña Salida del panel Ejecutar salida y configúralo como un Esquema de salida :
   1. Abre el panel Gestor de datos .
   2. En la pestaña Salida , selecciona Generar a partir de carga útil.
   3. Pega el resultado copiado y selecciona Generar esquema.