Para tener un ejemplo sencillo utilizaremos divisas, que tiene pocos elementos. Accedemos a http://localhost:8000/api/3/divisas
Este listado viene por defecto limitado a 50 elementos y empieza por el primer elemento. Por tanto, sería equivalente a añadir como parámetros ?limit=50&offset=0. Hay que tener esto en cuenta, porque puede que para su aplicación sea conveniente leer más o menos registros de golpe.
Para obtener más resultados será necesario indicar a partir de qué elemento queremos seguir recibiendo datos. Para este ejemplo seguiremos a partir del 1:
http://localhost:8000/api/3/divisas?offset=1
Partiendo de los parámetros offset y limit, podemos montar la paginación de la forma que sea más conveniente:
Para un limit de 3 (3 elementos por página):
?offset=0&limit=3
: devolverá los elementos 0, 1, 2.?offset=3&limit=3
: devolverá los elementos 3, 4, 5.?offset=6&limit=3
: devolverá los elementos 6, 7, 8.Podemos aplicar distintos filtros al listado para obtener solamente aquellos resultados que concuerden con los filtros. Para ello simplemente debemos añadir el parámetro filter[nombre_columna]=valor
Obtener todos los registros con el valor ARS en coddivisa:
http://localhost:8000/api/3/divisas?filter[coddivisa]=ARS
Obtener todos los registros con el valor ARS en coddivisa y el valor 32 en codiso:
http://localhost:8000/api/3/divisas?filter[coddivisa]=ARS&filter[codiso]=32
Obtener todos los registros con un valor de tasaconv superior a 2:
http://localhost:8000/api/3/divisas?filter[tasacon_gt]=2
Los filtros por defecto aplican el operador "=", pero es posible aplicar otros operadores añadiendo un sufijo al nombre de la columna. Ejemplos:
Por defecto cada filtro se aplica con una operación AND, es decir, se aplican todos los filtros a los resultados, pero podemos hacer que la operación sea OR. Por ejemplo para obtener el listado de todas las divisas que contengan PESO en su descripción O QUE su tasaconv sea mayor que 2.
http://localhost:8000/api/3/divisas?filter[descripcion_like]=PESO&filter[tasaconv_gt]=2&operation[tasaconv_gt]=OR
Obtener todos los registros que en descripcion contengan PESOS y ordenados por coddivisa de forma descendente:
http://localhost:8000/api/3/divisas?filter[descripcion_like]=PESOS&sort[coddivisa]=DESC
En la respuesta de la API, en el campo X-Total-Count de la cabecera recibimos el número total de registros de la consulta, sin aplicar limit ni offset, es decir:
Necesita identificarse para continuar con esta acción. Haga clic en iniciar sesión o cree una cuenta.
Iniciar sesiónEspaña, 10 años, nivel 100
FacturaScripts avanza más rápido gracias al apoyo financiero de los patrocinadores, que contribuyen a que podamos dedicar más tiempo al desarrollo, testeo y documentación. Usted también puede poner su granito de arena y convertirse en patrocinador ;-)
OROCon este curso aprenderá cómo crear un plugin sencillo para FacturaScripts 2021: añadir nuevas páginas, tablas y columnas. Para entender este curso no se necesita mucha experiencia en programación, le enseñaremos los básico para modelar problemas sencillos. ¿A quién va dirigido? A cualquier persona con unos conocimientos muy básicos de programación. ¿Qué incluye? 18 lecciones con 14 vídeos explicativos.
328 | 9,99 € |
Esta es una recopilación de vídeos y documentación de pequeños desarrollos sobre FacturaScripts y sus plugins. Perfecto para expandir tus conocimientos de programación. ¿A quién va dirigido? A personas que ya hayan superado el curso básico de programación y busquen ampliar sus conocimientos. ¿Qué incluye? 19 lecciones con 19 vídeos explicativos (más de 9 horas de vídeos) y el código fuente de los ejemplos. Novedades mensuales: Este curso se amplía cada mes con nuevas lecciones.
98 | 19,99 € |