Desarrolladores

Listar, filtrar y ordenar

Parámetros habituales para consultar colecciones de recursos en la API.

Actualizado el 25 de mayo de 2026

02 - Listar, filtrar y ordenar

Los recursos de datos se listan con GET /api/3/<recurso>. La respuesta es un array JSON.

Listado básico

curl "https://miempresa.beply.es/api/3/clientes" \
  -H "Token: tu-api-key-aquí"

Paginación

ParámetroUso
limitNúmero máximo de registros a devolver.
offsetNúmero de registros a saltar.
curl "https://miempresa.beply.es/api/3/productos?limit=50&offset=100" \
  -H "Token: tu-api-key-aquí"

Ordenación

Usa sort con el nombre del campo. Para ordenar descendente, antepón -.

/api/3/productos?sort=referencia
/api/3/productos?sort=-pvpunitario

Filtros

El patrón habitual es filter[campo]=valor. Algunos recursos admiten operadores por sufijo.

OperadorEjemploSignificado
Igualdadfilter[codcliente]=43000001Campo igual al valor.
Mayor quefilter[precio_gt]=50Mayor que 50.
Mayor o igualfilter[precio_gte]=10Mayor o igual que 10.
Menor o igualfilter[precio_lte]=100Menor o igual que 100.
/api/3/productos?filter[activo]=true&filter[pvpunitario_gte]=10&filter[pvpunitario_lte]=100&sort=-pvpunitario&limit=25

Los campos filtrables dependen del recurso y de los plugins instalados. Consulta /schema si necesitas generar filtros dinámicos.

¿Te ha resultado útil esta página?

¿Aún tienes dudas?

Habla con nuestro equipo y te resolvemos cualquier duda al instante.