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ámetro | Uso |
|---|---|
limit | Número máximo de registros a devolver. |
offset | Nú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.
| Operador | Ejemplo | Significado |
|---|---|---|
| Igualdad | filter[codcliente]=43000001 | Campo igual al valor. |
| Mayor que | filter[precio_gt]=50 | Mayor que 50. |
| Mayor o igual | filter[precio_gte]=10 | Mayor o igual que 10. |
| Menor o igual | filter[precio_lte]=100 | Menor 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
/schemasi necesitas generar filtros dinámicos.