Paginación

Todos los endpoints index (GET /products, GET /customers, etc.) paginan por offset.

Parámetros

Query	Default	Máx	Descripción
page	1	—	Página solicitada, 1-indexed.
limit	25	100	Items por página. Pedir más de 100 lo recortamos a 100 silenciosamente.

Forma del response

{
  "data": [ { "..." } ],
  "meta": {
    "page":        1,
    "limit":       25,
    "total":       142,
    "total_pages": 6
  }
}

• total es el conteo total de records que matchean (no de la página).
• total_pages se calcula ceil(total / limit).

Ejemplo

curl 'https://developers.fi-nova.com/api/v1/products?page=2&limit=50' \
  -H 'Authorization: Bearer finova_sk_TU_SECRETO'

Recorrer todas las páginas

async function fetchAllProducts(secret) {
  const headers = { Authorization: `Bearer ${secret}` }
  const all = []
  let page = 1

  while (true) {
    const res  = await fetch(
      `https://developers.fi-nova.com/api/v1/products?page=${page}&limit=100`,
      { headers }
    )
    const body = await res.json()
    all.push(...body.data)

    if (page >= body.meta.total_pages) break
    page += 1
  }

  return all
}

Por qué no cursor-based

Para Fase 1 nos quedamos con offset por simplicidad. Si tu integración requiere recorrer catálogos muy grandes (>10k items) o sincronizaciones consistentes a través del tiempo, contáctanos — probablemente saldrá una versión cursor en una iteración futura.