Paginación

OmniBuy usa cursor-based pagination en todos los endpoints de listado. Esto garantiza resultados estables incluso cuando el dataset cambia entre páginas.

Parámetros

Parámetro	Tipo	Default	Descripción
cursor	string	—	Cursor opaco de la página anterior
limit	int	25	Items por página (máx. 100)

Respuesta

{
  "data": [ ... ],
  "meta": {
    "pagination": {
      "cursor": "eyJpZCI6IjEyMyJ9",
      "has_next": true,
      "limit": 25
    }
  }
}

Cuando has_next es false, llegaste al final.

Iterar páginas

# Página 1
curl ".../products?limit=25"

# Página 2 (usar el cursor recibido)
curl ".../products?limit=25&cursor=eyJpZCI6IjEyMyJ9"

Filtros y ordenamiento

# Filtrar por estado
curl ".../products?filter[status]=active"

# Múltiples filtros
curl ".../products?filter[status]=active&filter[vendor]=Acme"

# Ordenar descendente por fecha
curl ".../products?sort=-created_at"

# Ordenar por varios campos
curl ".../products?sort=-created_at,title"

tip

El prefijo - indica orden descendente. Sin prefijo, es ascendente.