Paginación

Los endpoints que devuelven listas usan paginación por `offset` y `limit` mediante query params.

Parámetros

offset — número de elementos a saltar (por defecto 0).
limit — tamaño de página (por defecto 30, máximo 100).

curl

curl "https://api.lueira.com/api/v1/customers?offset=30&limit=30" \
  -H "Authorization: Bearer luk_..."

Headers de respuesta

Cada respuesta paginada incluye:

X-Total-Count — número total de elementos que cumplen el filtro.
Link — URL de la siguiente página con rel="next", presente solo si hay más resultados.

Recorrer todas las páginas

Node.js

async function* eachCustomer(apiKey) {
  let url = "https://api.lueira.com/api/v1/customers?limit=100";
  while (url) {
    const res = await fetch(url, {
      headers: { Authorization: `Bearer ${apiKey}` },
    });
    const { data } = await res.json();
    for (const c of data) yield c;
    url = parseNextLink(res.headers.get("Link"));
  }
}

Cuando el header Link no aparece, has llegado a la última página.