Paginación

En esta guía veremos cómo trabajar con respuestas paginadas al consultar la API de Fystack. De forma predeterminada, las respuestas de listas limitan los resultados a 20. Puedes solicitar hasta 1000 elementos agregando un parámetro limit. Si usas una de las bibliotecas cliente oficiales de la API de Fystack, no necesitas preocuparte por la paginación, ya que se gestiona internamente.

Cuando una respuesta de la API devuelve una lista de objetos, sin importar la cantidad, se admite la paginación. En las respuestas paginadas, los objetos se anidan en un atributo data. Puedes usar los parámetros de consulta offset y limit para recorrer las páginas.

Ejemplo con paginación por offset

En este ejemplo, solicitamos la primera página de redes con un límite de 10 elementos. Puedes navegar entre páginas ajustando el valor de offset. Por ejemplo, para obtener la segunda página, usarías offset=10 cuando tu limit es 10.

Name
offset
Type
integer
Description
La cantidad de elementos que se omiten antes de empezar a reunir el conjunto de resultados.
Name
limit
Type
integer
Description
Limita la cantidad de elementos devueltos por página. El valor máximo es 1000.

Pagination using cURL

curl -G https://api.fystack.io/api/v1/networks \
  -d offset=0 \
  -d limit=10

Paginated response

{
  "data": [
    {
      "id": "WAz8eIbvDR60rouK",
      // ...
    },
    {
      "id": "hSIhXBhNe8X1d8Et"
      // ...
    },
    {
      "id": "fbwYwpi9C2ybt6Yb"
      // ...
    }
    // ... 7 more items
  ]
}