Uso de los filtros en Skyone Studio

Para realizar consultas avanzadas en la API de Skyone Studio, utilice el parámetro de consulta (query). El valor de este parámetro debe ser un objeto JSON válido enviado bajo el patrón de underline query.

Estructura Base del JSON

A continuación, se presenta la estructura completa que incluye ordenamiento, filtrado por período y paginación:

{
  "sort": {
    "startTimeUTC": -1
  },
  "filter": {
    "startTimeUTC": {
      "_period_greater_equal": "2026-01-01T00:00:00Z",
      "_period_smaller_equal": "2026-01-06T23:59:59Z"
    }
  },
  "pagination": {
    "limit": 10,
    "skip": 0
  }
}

A continuación, comprenda mejor cada elemento:

Paginación (Pagination)

Controla la cantidad de datos devueltos por solicitud para optimizar el rendimiento.

• limit: Define el número máximo de elementos por página.

• skip: Define cuántos elementos se deben omitir (offset) para acceder a las siguientes páginas.

Ejemplo:

"pagination": {
  "limit":10
  "skip": 0
}

Filtro (Filter)

El objeto filter permite refinar su búsqueda utilizando claves específicas y operadores de comparación.

Operador	Descripción	Ejemplo de Uso
_equal	Filtra los registros cuyo valor de la columna coincide exactamente con el valor especificado, respetando los caracteres y la distinción entre mayúsculas y minúsculas.	"status": {"_equal": "active"}
_diff	Filtra los registros cuyo valor de la columna no coincide con el valor especificado.	"id": {"_diff": 0}
_like	Filtra los registros en los que el valor de la columna contiene el término buscado, permitiendo búsquedas parciales.	"name": {"_like": "Sky"}
_greater	Filtra los registros cuyo valor de la columna es mayor que el valor especificado.	"price": {"_greater": 50}
_smaller	Filtra los registros cuyo valor es menor que el valor límite especificado.	"stock": {"_smaller": 10}
_greater_equal	Filtra los registros cuyo valor es mayor o igual al valor límite especificado.	"age": {"_greater_equal": 18}
_smaller_equal	Filtra los registros cuyo valor es menor o igual al valor límite especificado.	"limit": {"_smaller_equal": 100}
_exists	Filtra los registros con base en la existencia del campo/columna en el documento, devolviendo aquellos en los que el campo está presente (true) o ausente (false), independientemente de su valor.	"tag": {"_exists": true}
_not_exists	Filtra los registros en los que el campo/columna no existe en el documento, independientemente del valor.	"deletedAt": {"_not_exists": true}
_in	Filtra los registros cuyo valor de la columna está contenido en una lista (array) de valores proporcionados.	"role": {"_in": ["admin", "editor"]}

Filtros de Período (Fecha/Hora)

Para campos de fecha como startTimeUTC, utilice los siguientes prefijos de período:

• _period_greater: Fecha posterior a.

• _period_smaller: Fecha anterior a.

• _period_greater_equal: Fecha inicial (inclusive).

• _period_smaller_equal: Fecha final (inclusive).

En el escenario siguiente, el filtro actúa como un operador && (and):

"startTimeUTC": {
      "_period_greater_equal": "2026-01-01T00:00:00Z",
      "_period_smaller_equal": "2026-01-06T23:59:59Z"
    }

Ordenamiento (Sort)

Define la dirección en la que se devuelven los resultados basándose en una clave:

• -1: Orden Descendente (por defecto).

• 1: Orden Ascendente.

Ejemplo:

{
  "sort":{
    "startTimeUTC":-1
  }