Paginación y filtros

Hay dos estilos, a propósito. Cuál usa un endpoint se ve en su respuesta.

Cursor — para lo que crece por la punta

Registros de entrega, historial de sincronización de integraciones, conversaciones, mensajes. Estas listas ganan filas por el extremo más nuevo todo el tiempo, así que un desplazamiento numérico se mueve bajo tus pies entre una página y la siguiente: verías una fila dos veces y perderías otra entera.

bash

curl "https://api.zapyflow.com.br/api/integrations/sync-jobs?limit=50" \
  -H "Authorization: Bearer $ZAPYFLOW_API_KEY"

json

{
  "jobs": [ ... ],
  "nextCursor": "cmt1naffo00113tuykpbzlvm9"
}

Devuelve el valor en ?cursor=. Un cursor null significa que llegaste al final. No construyas cursores por tu cuenta — trátalos como opacos.

Número de página — para colecciones pequeñas y estables

Contactos, pedidos, ítems de catálogo. Los navega una persona, que espera que la “página 3” signifique lo mismo dos veces, y su tasa de escritura es lo bastante baja como para que la deriva no sea un problema práctico.

bash

curl "https://api.zapyflow.com.br/api/contacts?page=2&limit=50" \
  -H "Authorization: Bearer $ZAPYFLOW_API_KEY"

El limit tiene un tope de 100 en todas partes. Pedir más se recorta, no se rechaza — pero no construyas sobre el recorte; pide lo que quieres.

Filtros

Los filtros son parámetros de query normales, con vocabulario fijo (status, from, to, search). No existe un lenguaje de expresiones de filtro, y no lo habrá: una gramática que nadie lee es fuente permanente de errores de análisis en ambos lados.

Las fechas son ISO-8601. Donde un filtro significa “un día”, el día se resuelve en la zona horaria del workspace, no en UTC — un pedido hecho a las 21:00 en São Paulo pertenece a ese día, no al siguiente.