En la API de Analytics, es posible utilizar filtros de fecha para optimizar las consultas. Es importante señalar que, de acuerdo con la documentación, todas las fechas siempre se informarán en formato ISO 8601 y los registros se devolverán con Timezone UTC.
- Comparadores de operaciones
- Ejemplos de filtros por fecha y zona horaria
- Consulta de múltiples status
- Consulta de registros no eliminados
Comparadores de operaciones
Al filtrar por fechas, podemos utilizar comparadores para definir periodos específicos para la consulta:
- [eq]: Igual a.
- [gte]: Mayor o igual a.
- [lte]: Menor o igual a.
Cuando no se envía un comparador en la consulta, el sistema lo interpretará automáticamente como [eq] (igual a).
Ejemplos de filtros por fecha y zona horaria
Utilizando la consulta de evaluación (Checklists aplicados), podemos realizar solicitudes con criterios temporales exactos. Tenga en cuenta la diferencia entre la zona horaria utilizada en el filtro y la devolución de la API.
Evaluaciones completadas después de una fecha y hora específica:
Evaluaciones en curso que iniciaron después de un periodo determinado:
Consulta de fecha exacta (sin operador de comparación):
Consulta de múltiples status
Es posible solicitar múltiples estados en la misma solicitud (ej: evaluaciones en curso y completadas). Para esto, el parámetro de filtro "status" se informa dos veces con el sufijo [], indicando que se pasa más de un valor (ej: 2 para "en progreso" y 6 para "finalizado").
Consulta de registros no eliminados
Para filtrar evaluaciones que no han sido borradas, usamos el filtro deleteAt con el valor null. Esto indica a la API que solo queremos registros donde el campo de fecha de eliminación esté vacío.
❓Tem dúvidas? Entre em contato com nosso time de suporte.