--- title: "How to Set Query Parameters" slug: "how-to-set-query-parameters" updated: 2025-01-08T14:16:12Z published: 2025-01-08T14:16:12Z canonical: "support.tulip.co/how-to-set-query-parameters" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Cómo establecer parámetros de consulta *Aprenda los fundamentos del trabajo con parámetros de consulta en sus Funciones de Conector HTTP de acuerdo con la documentación de la API.* **Access Tulip's [API documentation here](https://support.tulip.co/apidocs).** Los parámetros de consulta te permiten refinar y adaptar los resultados de una función de conector. Utiliza los parámetros para ordenar, filtrar, establecer límites, compensar un índice, etc. Este artículo utiliza los parámetros de la API de Tulip Table, pero otras APIs pueden tener requisitos de parámetros diferentes. Asegúrate de consultar la documentación para comprobar que estás utilizando la sintaxis y las especificaciones correctas. ## Consultas con filtros Los filtros pueden ser muy útiles para extraer sólo los datos que le interesan. Estos filtros a veces pueden ser un poco complicados con su sintaxis. A continuación se describe cómo se forma cada uno en el ejemplo de una solicitud GET de registros, seguido de un ejemplo completo. Los**nombres de** los campos personalizados siempre van precedidos de un identificador de cadena de cinco dígitos. Estos se pueden encontrar más fácilmente después de una solicitud GET all para comprobar el verdadero nombre del campo. - Ej. "field"="maytq_scrap_count". Los valores de**los argumentos** suelen ser sencillos. Si se trata de un valor de texto, asegúrese de ponerlo entre comillas. - Ej. "arg":15 Haga coincidir el **tipo de función** que desea utilizar. - Ej. "functionType": "mayorQue" Una solicitud completa podría tener este aspecto: `https://brian.tulip.co/api/v3/tables/W2HPvyCZrjMMHTiip/records?limit=100&sortBy=\_sequenceNumber&sortDir=asc&filters=[{"field": "maytq\_scrap\_count", "arg":15, "functionType": "greaterThan"}]&filterAggregator=any` ## Cómo encontrar parámetros de consulta en la documentación Para localizar los parámetros de consulta disponibles para su solicitud, navegue hasta la documentación de la API. Si está utilizando la API de Tulip Table, puede encontrar la documentación en: your-instance.tulip.co/apiDocs.Seleccione la solicitud que desea utilizar y, a continuación, desplácese hasta la pestaña **Parámetros**. ![Parameters in API Docs.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Parameters%20in%20API%20Docs.png) Cada método individual tiene su propio conjunto de parámetros, sin embargo, no todas las solicitudes tienen parámetros asociados. Asegúrese de anotar lo que está disponible en la documentación de antemano. ## Sintaxis de los parámetros de consulta La sintaxis de los parámetros de consulta se basa en un [formato de cadena de consulta](https://en.wikipedia.org/wiki/Query_string). Este formato asigna valores a los parámetros especificados, siendo la propia cadena de consulta parte de la URL. En el Editor de funciones del conector, haz clic en **Añadir parámetro** para crear un nuevo parámetro de consulta. ![Query Parameters - Add Parameter.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Add%20Parameter.png) Hay dos partes en un parámetro de consulta: una **clave** y un **valor**. La clave es el nombre del parámetro y el valor es la información que establece el parámetro para los resultados. La sintaxis de los parámetros de consulta utiliza Dot Notation, que especifica el tipo exacto de parámetro. Asegúrese de que la escritura coincide con el estándar API del otro sistema. ## Aplicar parámetros comunes a funciones de conector Para establecer un parámetro en su función de conector, identifique primero el parámetro que desea utilizar en la documentación de la API. Los parámetros tienen distintos requisitos para cada uno, así que repasemos cómo son. NOTE For continuity purposes, we’ll use the same request API Call in each of the examples below. This is the GET request that retrieves a list of records in a tulip Table via the Tulip Table API. Other APIs you use will have different specifications for parameters, be sure to look at the API documentation requirements. ### Límites Los límites establecen un tope designado para los resultados devueltos. Tenga en cuenta que algunos límites tienen valores predeterminados, así que asegúrese de consultar la documentación de la API para conocer el valor inicial. **EjemploNo**queremos obtener más de 70 registros cuando se ejecute la función de conector. Por suerte, el valor por defecto para el límite en esta petición es 10 y el más alto es 100. La sintaxis para el parámetro de consulta debería ser la siguiente ![Query Parameters - Limits.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Limits.png) ### Filtros Los filtros separan y refinan los resultados basándose en la información dada en el parámetro. Los filtros tienen tres partes, que debe escribir en parámetros individuales: - Campo - el nombre de la columna en la tabla - Tipo de función - el tipo de función de comparación - Argumento - el valor con el que se compararán los resultados Cada filtro tiene 3 partes y cada filtro completo es un Objeto. Utilizando la notación de puntos para escribir cada clave, especifique el tipo de parámetro ('filtro'), el número de filtro (de 0 a n) y la parte del filtro ('campo', 'tipo de función' o 'arg'). Debe haber un parámetro para las tres partes del filtro. **EjemploQueremos**asegurarnos de que los resultados de la función de conector muestren sólo valores de un campo específico (eubmc_value) que sea igual al valor de entrada especificado (consumable) de la función. Dado que éste es nuestro primer filtro en los parámetros de la función, el número de filtro es 0. Esto significa que todas las claves de este filtro empezarán por 'filtro.0'. La sintaxis de este filtro debería ser la siguiente: ![Query Parameters - Filters.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Filters.png) ### Ordenación La ordenación de los resultados prioriza la vista en función de la información del parámetro. Los resultados ordenados determinan cuáles se incluyen en las agregaciones. Puede tener múltiples funciones de ordenación, sin embargo el orden de las opciones determina la prioridad de ordenación. Las funciones de ordenación tienen dos partes - sortBy - el campo por el que desea ordenar los resultados - sortDir - la dirección de la ordenación, ascendente (asc) o descendente (desc) Cada función de ordenación consta de 3 partes. Utilizando la notación de puntos para escribir cada clave, especifique el tipo de parámetro ('sortOptions'), el número de ordenación (de 0 a n) y el argumento de ordenación ('sortBy' o 'sortDir'). Debe haber un parámetro para las tres partes de la función de ordenación para que funcione. **EjemploQueremos**que los resultados de la función conector se ordenen por el campo actualizado más reciente en orden ascendente. Debido a que esta es nuestra primera función de ordenación, el número de ordenación es 0. Esto significa que ambas claves para esta ordenación comenzarán con 'sortOptions.0'. Para la clave sortBy, el valor es un valor especial ('_updatedAt') derivado de la documentación de la API para ordenar por campos actualizados. La sintaxis de estos parámetros debe ser la siguiente ![Query Parameters - Sorting.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Sorting.png) ### Desplazamientos Los desplazamientos determinan el índice en el que comienza el resultado devuelto. Este parámetro se utiliza para la paginación, no para el orden de los registros, que viene determinado por los parámetros de ordenación. El valor del parámetro debe ser un número entero mayor o igual que 0. **EjemploQueremos**ver sólo los registros a partir de la 5ª posición, para no ver los 5 primeros resultados. La sintaxis del parámetro de consulta debe ser la siguiente ![Query Parameters - Offset.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Offset.png) ### Agregadores de filtros Los agregadores de filtros determinan cómo se combinan los filtros en los parámetros. Los dos valores a elegir son 'any' y 'all'. El valor 'all' significa que todos los filtros deben tener un registro para que el registro se incluya en los resultados. El valor "cualquiera" significa que al menos uno de los filtros debe coincidir con un registro para que se incluya en los resultados. El valor por defecto es "todos", independientemente de que se haya establecido o no el parámetro. **EjemploTenemos**una serie de filtros en los parámetros de consulta, pero sólo necesitamos que uno de ellos sea verdadero para que los registros coincidan con nuestra petición. La sintaxis del parámetro de consulta debería ser la siguiente ![Query Parameter - Filter Aggregators.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameter%20-%20Filter%20Aggregators.png) ### Filtros múltiples En algunos casos, puede que tenga varios filtros que comprobar en la tabla. En este caso, puede añadir múltiples al objeto filters. Esto podría ser algo como esto `filters=[{"field": "maytq\_scrap\_count", "arg":15, "functionType": "greaterThan"},{"field": "maytq\_scrap\_reason", "arg": "scratch", "functionType": "equal"}].` ## Más información - [Visión general de los conectores HTTP](/r230/docs/an-overview-of-http-connectors) - [Cómo crear y configurar una función de conector HTTP](/r230/docs/how-to-create-and-configure-an-http-connector-function) - [Cómo utilizar la API de tablas](/r230/docs/how-to-use-the-table-api) **Dot Notation** **Dot notation** is a way to access a property of an object. Structure dot notation by using the name of an object, followed by a dot, followed by the name of the property. **Example**: data.Id.datetime **API Call** An **API call** is a message sent to a server asking an API to provide a service or information.