---
title: "Formát požiadavky — Query Builder for Laravel | Roundly"
description: "Zmrazená syntax query stringu pre filtre, operátory, triedenie a stránkovanie a stavový kód, ktorý vráti každá chyba."
url: https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel/format-poziadavky
language: sk
---

[Všetky balíky](https://roundly-consulting.com/sk/open-source.md)

[Query Builder for Laravel](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel.md)

# Formát požiadavky

Formát query stringu je zmrazený kontrakt — frontendy aj uložené odkazy fungujú ďalej, aj keď sa balík vyvíja. S predvolenými názvami parametrov:

| Oblasť | Syntax | Význam |
| --- | --- | --- |
| Filter | `filter[<name>]=<value>` | Jeden parameter na filter; <name> je kľúč z allow-listu. |
| Viachodnotový filter | `filter[<name>]=a,b,c` | Rozdelí sa podľa čiarok → pole; exact → whereIn. |
| Hodnota ako pole | `filter[<name>][]=a` | Jedna úroveň vnorenia sa zarovná do zoznamu. |
| Booleovská hodnota | `filter[<name>]=true / false` | Skutočný bool (aj 1/0, v ľubovoľnej veľkosti písmen) len pre filter, ktorý si o to povie — boolean(), FilterValueShape::Boolean, booleans: true. Každý iný filter dostane text. |
| Vyhľadávaná fráza | `filter[<name>]=Smith, John` | Len search(): jedna fráza — čiarka je jej súčasťou, operátor sa nečíta a prázdna fráza znamená žiadny filter. |
| Operátor | `filter[<name>]=<token>:<value>` | Len operators(), nullable(), relation() a jsonContains(); nedeklarovaný token ostáva súčasťou hodnoty. |
| Nenastavené | `filter[<name>]=none / not:none` | Sentinel pre nullable() a pre relation(), ak ho dostane. |
| Triedenie vzostupne / zostupne | `sort=field / sort=-field` | Úvodné - = zostupne. |
| Viac triedení | `sort=-created_at,name` | Zľava doprava; duplicitné stĺpce sa zlúčia do prvého, najviac limits.max\_sorts (rátajú sa len triedenia z allow-listu). |
| Stránkovanie | `page=<n>&per_page=<n>` | Názvy paginatora z Laravelu; per\_page validuje HasPageSize. |
| Neznámy kľúč filtra/triedenia | Akýkoľvek kľúč mimo allow-listu | HTTP 400 (alebo sa v režime ignore zahodí; ak sa zahodia všetky triedenia, použije sa predvolené). |
| Neplatné per\_page | \> max, < 1, necelé číslo | HTTP 422. |

## Celý request

Request, ktorý využíva všetky časti kontraktu (endpoint musí deklarovať každý filter aj triedenie):

```
GET /posts?filter[status]=not:draft,archived&filter[title]=laravel&filter[project]=none&sort=-created_at,title&page=2&per_page=25
```

Názvy parametrov pochádzajú z parameters.\* a pagination.\* v konfigurácii; meňte ich len spolu s frontendom.

## Prejavte lásku k open source

Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.

[Ďalšie spôsoby podpory vrátane kryptomien](https://roundly-consulting.com/sk/podporte-nas.md)

Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md).

[Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly)

## Chcete to zabudovať do svojho produktu?

Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.

[Ponuka do 48 hodín](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source/navody/query-builder-for-laravel.md)