Condiciones de Filtro

Con frecuencia, tu base de datos puede tener una gran cantidad de registros, asique es mejor aplicar filtros al recuperar datos. Los filtros de API Ragic están en un formato especial.

Puedes usar el parámetro “where” para agregar una condición e3 filtro hacer query como a continuación:

curl --get -d "where=800003,eq,Dwight Schrute" \
-H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
-d api \
https://www.ragic.com/demo/sales/1

El parámetro es un formato delimitado por comas “,” con al menos 3 argumentos.

• 1. El ID de campo que deseas filtrar.
• 2. El operador en la forma de entero para especificar tu filtro de operación. La lista de operadores se muestra en la parte inferior.
• 3. El valor con el que deseas filtrar el campo. Recuerda, si tu valor puede incluir un caracter de coma “,” por favor usa codificación de URL o usa %2C para evitar colisiones.

Puedes hacer una query con múltiples condiciones de filtro como se muestra a continuación:

curl --get -d "where=800003,eq,Dwight Schrute" \
-d "where=800007,eq,Reseller" \
-H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
-d api \
https://www.ragic.com/demo/sales/1

Esta es la lista de los operadores que puedes usar:

Por favor nótese que:

1. Cuando filtras por fecha o fecha y hora, deberán estar en el siguiente formato: yyyy/MM/dd o yyyy/MM/dd HH:mm:ss.

2. No necesitas rellenar el tercer argumento si deseas filtrar por valores vacíos, por ejemplo, "where=800003,eq," \.

Hay algunos campos de sistema que tienen IDs especiales de campo los cuales puedes usar en tu query. Los campos de sistemas se muestran a continuación:

Puedes usar una búsqueda de texto completo como filtro de query. Sólo provee tu término de búsqueda en el parámetro fts y el resultado coincidente será devuelto.

curl --get -d "fts=Dwight" \
-H "Authorization:Basic TU_CLAVE_API_VA_AQUÍ" \
-d api \
https://www.ragic.com/demo/sales/1

También puedes aplicar una Vista Compartida. Sólo fija el id como se muestra a continuación:

curl --get -d "filterId=EL_ID_DE_TU_VISTA_COMPARTIDA" \
-H "Authorization:Basic TU_CLAVE_API_VA_AQUÍ" \
-d api \
https://www.ragic.com/demo/sales/1

Puedes obtener el id al hacer clic en compartir URL de la vista.