--- title: "How to Set Query Parameters" slug: "how-to-set-query-parameters" updated: 2025-01-08T14:17:20Z published: 2025-01-08T14:17:20Z 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. # A lekérdezési paraméterek beállítása *Ismerje meg a lekérdezési paraméterekkel való munka alapjait a HTTP-csatlakozófunkciókban az API dokumentációval összhangban.* A lekérdezési paraméterek lehetővé teszik a csatlakozófüggvények eredményeinek finomítását és testre szabását. Használja a paramétereket rendezéshez, szűréshez, korlátok beállításához, index eltolásához és még sok máshoz. Ez a cikk a Tulip Table API paramétereit használja, de más API-k eltérő paraméterkövetelményekkel rendelkezhetnek. Ellenőrizze a dokumentációt, hogy a helyes szintaxist és specifikációkat használja. ## Szűrőkkel történő lekérdezés A szűrők nagyon hasznosak lehetnek ahhoz, hogy csak az Önt érdeklő adatokat nyerje ki. Ezek a szűrők néha kicsit trükkösek lehetnek a szintaxisukkal. Az alábbiakban a rekordok GET-kérelmének példáján, majd egy teljes példán keresztül ismertetjük az egyes szűrők kialakítását. Az egyéni**mezők mezőnevei** elé mindig egy ötjegyű karakterlánc-azonosító kerül. Ezeket legkönnyebben egy GET all kérés után lehet megtalálni, hogy ellenőrizni lehessen a mező valódi nevét. - Pl. "mező"="maytq_scrap_count" **Az argumentumértékek** gyakran egyszerűek. Ha szöveges értékről van szó, mindenképpen tegye idézőjelbe. - Pl. "arg":15 Egyeztesse a használni kívánt **függvénytípussal**. - Pl. "functionType": "greaterThan" Egy teljes kérés erre a célra valahogy így nézhet ki: `{"field": "maytq\_scrap\_count", "arg":15, "functionType": "greaterThan"}]&filterAggregator=any` ## Hogyan találja meg a lekérdezési paramétereket a dokumentációban A kérelemhez rendelkezésre álló lekérdezési paraméterek megtalálásához navigáljon az API dokumentációjához. Ha a Tulip Table API-t használja, a dokumentációt a következő címen találja: your-instance.tulip.co/apiDocs.Válassza ki a használni kívánt kérést, majd görgessen le a **Paraméterek** fülre. ![Parameters in API Docs.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Parameters%20in%20API%20Docs.png) Minden egyes módszer saját paraméterkészlettel rendelkezik, azonban nem minden kéréshez tartoznak paraméterek. Győződjön meg róla, hogy a dokumentációban előzetesen megjegyzi, hogy mi áll rendelkezésre. ## A lekérdezési paraméterek szintaxisa A paraméterek szintaxisának lekérdezése a [lekérdezési karakterlánc formátumára](https://en.wikipedia.org/wiki/Query_string) támaszkodik. Ez a formátum értékeket rendel a megadott paraméterekhez, maga a lekérdezési karakterlánc pedig az URL része. A Csatlakozófunkció-szerkesztőben kattintson a **Paraméter hozzáadása** gombra egy új lekérdezési paraméter létrehozásához. ![Query Parameters - Add Parameter.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Add%20Parameter.png) Egy lekérdezési paraméter két részből áll: egy **kulcsból** és egy **értékből**. A kulcs a paraméter neve, az érték pedig az az információ, amely a paramétert az eredményekhez beállítja. A lekérdezési paraméterek szintaxisában a Dot Notation használatos, amely pontosan meghatározza a paraméter típusát. Győződjön meg arról, hogy az írásmód megfelel a másik rendszer API-szabványának. ## Közös paraméterek alkalmazása a csatlakozófüggvényekhez Ahhoz, hogy egy paramétert beállítson a csatlakozófüggvényéhez, először azonosítsa a használni kívánt paramétert az API dokumentációban. A paramétereknek eltérő követelményei vannak, ezért nézzük át, hogy ezek hogyan néznek ki. 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. ### Korlátok A korlátok egy kijelölt felső határt állítanak be a visszaküldött eredményekre. Vegye figyelembe, hogy egyes korlátok alapértelmezett beállításokkal rendelkeznek, ezért mindenképpen nézze meg az API dokumentációját a kezdeti érték megértéséhez. **PéldaA**csatlakozó függvény futtatásakor legfeljebb 70 rekordot szeretnénk kapni. Szerencsére a limit alapértelmezett értéke ebben a kérésben 10, a legmagasabb pedig 100. A lekérdezési paraméter szintaxisának a következőképpen kell kinéznie: ![Query Parameters - Limits.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Limits.png) ### Szűrők A szűrők a paraméter megadott információi alapján választják szét és finomítják az eredményeket. A szűrők három részből állnak, amelyeket külön paraméterekben kell megírni: - Mező - a táblázat oszlopának neve. - Function Type - az összehasonlító függvény típusa - Argumentum - az az érték, amellyel az eredményeket összehasonlítja Minden szűrő 3 részből áll, és minden teljes szűrő egy Object. Az egyes kulcsok megírásához a pontjelölést használva adja meg a paraméter típusát ('filter'), a szűrő számát (0-tól n-ig) és a szűrő részét ('field', 'functionType' vagy 'arg'). A szűrő mindhárom részéhez kell paramétert adni. **PéldaMeg**akarjuk győződni arról, hogy a csatlakozófüggvény eredményei csak egy adott mező (eubmc_value) értékeit mutatják, amelyek megegyeznek a függvény megadott bemeneti értékével (consumable). Mivel ez az első szűrőnk a függvény paramétereiben, a szűrő száma 0. Ez azt jelenti, hogy ennek a szűrőnek minden kulcsa 'filter.0'-val kezdődik. Ennek a szűrőnek a szintaxisának a következőképpen kell kinéznie: ![Query Parameters - Filters.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Filters.png) ### Rendezés Az eredmények rendezése a nézetet a paraméter információi alapján rangsorolja. A rendezett eredmények határozzák meg, hogy melyek kerülnek bele az összesítésbe. Többféle rendezési funkciót is használhat, azonban az opciók sorrendje határozza meg a rendezési prioritást. A rendezési függvényeknek két része van: - sortBy - az a mező, amely alapján az eredményeket rendezni kívánja. - sortDir - a rendezés iránya, növekvő (asc) vagy csökkenő (desc). Minden egyes rendezési függvény 3 részből áll. Az egyes kulcsok írásához pontjelöléssel írjuk le a paraméter típusát ('sortOptions'), a rendezési számot (0-tól n-ig) és a rendezési argumentumot ('sortBy' vagy 'sortDir'). A rendezési függvény mindhárom részének kell paraméter, hogy működjön. **PéldaA**csatlakozó függvény eredményeit a legfrissebb frissített mező szerint szeretnénk növekvő sorrendben rendezni. Mivel ez az első rendezési függvényünk, a rendezési szám 0. Ez azt jelenti, hogy a rendezés mindkét kulcsa 'sortOptions.0'-val kezdődik. A sortBy kulcs értéke egy speciális érték ('_updatedAt'), amely az API dokumentációból származik a frissített mezők rendezéséhez. Ezeknek a paramétereknek a szintaxisának a következőképpen kell kinéznie: ![Query Parameters - Sorting.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Sorting.png) ### Offsets Az eltolások határozzák meg, hogy a visszaadott eredmény milyen indexről induljon. Ezt a paramétert a lapozáshoz használjuk, nem pedig a rekordok sorrendjére, amelyet a rendezési paraméterek határoznak meg. A paraméter értékének egy 0-nál nagyobb vagy azzal egyenlő egész számnak kell lennie. **PéldaMég**csak az 5. pozíció utáni rekordokat szeretnénk megtekinteni, hogy ne az első 5 találatot lássuk. A lekérdezési paraméter szintaxisának a következőképpen kell kinéznie: ![Query Parameters - Offset.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameters%20-%20Offset.png) ### Szűrő aggregátorok A szűrőaggregátorok határozzák meg, hogy a paraméterekben lévő szűrők hogyan kombinálódnak. A két választható érték az 'any' és az 'all'. Az 'all' érték azt jelenti, hogy az összes szűrőnek tartalmaznia kell egy rekordot ahhoz, hogy a rekord bekerüljön az eredmények közé. Az "any" érték azt jelenti, hogy legalább az egyik szűrőnek meg kell egyeznie egy rekorddal ahhoz, hogy az szerepeljen az eredmények között. Az alapértelmezett érték az 'all', függetlenül attól, hogy beállította-e a paramétert vagy sem. **PéldaEgy**sor szűrő van a lekérdezési paraméterekben, de csak az egyik szűrőnek kell igaznak lennie ahhoz, hogy a rekordok megfeleljenek a kérésünknek. A lekérdezési paraméter szintaxisának a következőképpen kell kinéznie: ![Query Parameter - Filter Aggregators.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Query%20Parameter%20-%20Filter%20Aggregators.png) ### Több szűrő Bizonyos esetekben előfordulhat, hogy a táblázatban több szűrőt is ellenőrizni kell. Ebben az esetben többszöröseket adhatunk a szűrők objektumhoz. Ez valahogy így nézhet ki: `},{"field": "maytq\_scrap\_count", "arg":15, "functionType": "greaterThan"},{"field": "maytq\_scrap\_reason", "arg": "scratch", "functionType": "equal"}]` ## További olvasmányok - [A HTTP-konnektorok áttekintése](/r230/docs/an-overview-of-http-connectors) - [Hogyan hozzunk létre és konfiguráljunk egy HTTP-csatlakozó funkciót?](/r230/docs/how-to-create-and-configure-an-http-connector-function) - [A táblázat API használata](/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.