Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://developers.flowestate.app/llms.txt

Use this file to discover all available pages before exploring further.

Los endpoints de lista aceptan estos parámetros de query:
ParámetroTipoDefaultNotas
limitentero 1..10050Tamaño de página.
offsetentero ≥ 00Cantidad de registros a saltar.
querystringBúsqueda libre por nombre, email, empresa, teléfono (donde aplique).
sortBystringcreatedAtEspecífico de cada endpoint.
sortOrderasc | descdesc

Recorriendo páginas

async function* iterateLeads(apiKey) {
  let offset = 0;
  const limit = 100;
  while (true) {
    const res = await fetch(
      `https://panel.flowestate.app/api/v1/leads?limit=${limit}&offset=${offset}`,
      { headers: { Authorization: `Bearer ${apiKey}` } }
    );
    const { data, pagination } = await res.json();
    for (const lead of data) yield lead;
    if (!pagination.hasMore) break;
    offset += limit;
  }
}
Detente cuando pagination.hasMore sea false.

Filtros

La mayoría de los endpoints de lista aceptan parámetros de filtro adicionales sobre los estándar — por ejemplo status y source en /leads. Los parámetros de filtro están listados por endpoint en la Referencia API.

Notas

  • No caches offsets en sesiones largas. Los registros nuevos se insertan al tope (orden por defecto createdAt desc), así que un offset que apuntaba a “página 5” ayer ya no es la misma ventana hoy. Repagina desde cero.
  • Para exportes grandes, considera ordenar sortBy=createdAt&sortOrder=asc y paginar cronológicamente. Así los inserts nuevos no te corren la posición.
  • limit está topado a 100. Valores más altos se clampean silenciosamente.