# Free Proxies API (Slovenčina)

🌐 **Languages:** 🇺🇸 [English](../../../../reference/FREE_PROXIES_API.md) · 🇪🇹 [am](../../../am/docs/reference/FREE_PROXIES_API.md) · 🇸🇦 [ar](../../../ar/docs/reference/FREE_PROXIES_API.md) · 🇦🇿 [az](../../../az/docs/reference/FREE_PROXIES_API.md) · 🇧🇬 [bg](../../../bg/docs/reference/FREE_PROXIES_API.md) · 🇧🇩 [bn](../../../bn/docs/reference/FREE_PROXIES_API.md) · 🇨🇿 [cs](../../../cs/docs/reference/FREE_PROXIES_API.md) · 🇩🇰 [da](../../../da/docs/reference/FREE_PROXIES_API.md) · 🇩🇪 [de](../../../de/docs/reference/FREE_PROXIES_API.md) · 🇬🇷 [el](../../../el/docs/reference/FREE_PROXIES_API.md) · 🇪🇸 [es](../../../es/docs/reference/FREE_PROXIES_API.md) · 🇪🇪 [et](../../../et/docs/reference/FREE_PROXIES_API.md) · 🇮🇷 [fa](../../../fa/docs/reference/FREE_PROXIES_API.md) · 🇫🇮 [fi](../../../fi/docs/reference/FREE_PROXIES_API.md) · 🇫🇷 [fr](../../../fr/docs/reference/FREE_PROXIES_API.md) · 🇮🇪 [ga](../../../ga/docs/reference/FREE_PROXIES_API.md) · 🇮🇳 [gu](../../../gu/docs/reference/FREE_PROXIES_API.md) · 🇳🇬 [ha](../../../ha/docs/reference/FREE_PROXIES_API.md) · 🇮🇱 [he](../../../he/docs/reference/FREE_PROXIES_API.md) · 🇮🇳 [hi](../../../hi/docs/reference/FREE_PROXIES_API.md) · 🇭🇷 [hr](../../../hr/docs/reference/FREE_PROXIES_API.md) · 🇭🇺 [hu](../../../hu/docs/reference/FREE_PROXIES_API.md) · 🇦🇲 [hy](../../../hy/docs/reference/FREE_PROXIES_API.md) · 🇮🇩 [id](../../../id/docs/reference/FREE_PROXIES_API.md) · 🇳🇬 [ig](../../../ig/docs/reference/FREE_PROXIES_API.md) · 🇮🇹 [it](../../../it/docs/reference/FREE_PROXIES_API.md) · 🇯🇵 [ja](../../../ja/docs/reference/FREE_PROXIES_API.md) · 🇬🇪 [ka](../../../ka/docs/reference/FREE_PROXIES_API.md) · 🇰🇭 [km](../../../km/docs/reference/FREE_PROXIES_API.md) · 🇮🇳 [kn](../../../kn/docs/reference/FREE_PROXIES_API.md) · 🇰🇷 [ko](../../../ko/docs/reference/FREE_PROXIES_API.md) · 🇱🇹 [lt](../../../lt/docs/reference/FREE_PROXIES_API.md) · 🇱🇻 [lv](../../../lv/docs/reference/FREE_PROXIES_API.md) · 🇮🇳 [ml](../../../ml/docs/reference/FREE_PROXIES_API.md) · 🇮🇳 [mr](../../../mr/docs/reference/FREE_PROXIES_API.md) · 🇲🇾 [ms](../../../ms/docs/reference/FREE_PROXIES_API.md) · 🇲🇹 [mt](../../../mt/docs/reference/FREE_PROXIES_API.md) · 🇲🇲 [my](../../../my/docs/reference/FREE_PROXIES_API.md) · 🇳🇵 [ne](../../../ne/docs/reference/FREE_PROXIES_API.md) · 🇳🇱 [nl](../../../nl/docs/reference/FREE_PROXIES_API.md) · 🇳🇴 [no](../../../no/docs/reference/FREE_PROXIES_API.md) · 🇮🇳 [or](../../../or/docs/reference/FREE_PROXIES_API.md) · 🇮🇳 [pa](../../../pa/docs/reference/FREE_PROXIES_API.md) · 🇵🇭 [phi](../../../phi/docs/reference/FREE_PROXIES_API.md) · 🇵🇱 [pl](../../../pl/docs/reference/FREE_PROXIES_API.md) · 🇵🇹 [pt](../../../pt/docs/reference/FREE_PROXIES_API.md) · 🇧🇷 [pt-BR](../../../pt-BR/docs/reference/FREE_PROXIES_API.md) · 🇷🇴 [ro](../../../ro/docs/reference/FREE_PROXIES_API.md) · 🇷🇺 [ru](../../../ru/docs/reference/FREE_PROXIES_API.md) · 🇱🇰 [si](../../../si/docs/reference/FREE_PROXIES_API.md) · 🇸🇮 [sl](../../../sl/docs/reference/FREE_PROXIES_API.md) · 🇷🇸 [sr](../../../sr/docs/reference/FREE_PROXIES_API.md) · 🇸🇪 [sv](../../../sv/docs/reference/FREE_PROXIES_API.md) · 🇰🇪 [sw](../../../sw/docs/reference/FREE_PROXIES_API.md) · 🇮🇳 [ta](../../../ta/docs/reference/FREE_PROXIES_API.md) · 🇮🇳 [te](../../../te/docs/reference/FREE_PROXIES_API.md) · 🇹🇭 [th](../../../th/docs/reference/FREE_PROXIES_API.md) · 🇹🇷 [tr](../../../tr/docs/reference/FREE_PROXIES_API.md) · 🇺🇦 [uk-UA](../../../uk-UA/docs/reference/FREE_PROXIES_API.md) · 🇵🇰 [ur](../../../ur/docs/reference/FREE_PROXIES_API.md) · 🇺🇿 [uz](../../../uz/docs/reference/FREE_PROXIES_API.md) · 🇻🇳 [vi](../../../vi/docs/reference/FREE_PROXIES_API.md) · 🇳🇬 [yo](../../../yo/docs/reference/FREE_PROXIES_API.md) · 🇨🇳 [zh-CN](../../../zh-CN/docs/reference/FREE_PROXIES_API.md) · 🇹🇼 [zh-TW](../../../zh-TW/docs/reference/FREE_PROXIES_API.md)

---

OmniRoute poskytuje starostlivo vybranú skupinu bezplatných proxy serverov v tabuľke `free_proxies`,
synchronizovanú z externých poskytovateľov (1proxy, proxifly, iplocate, webshare).
Ovládací panel ich zobrazuje v časti **Nastavenia → Bezplatné proxy servery**. Tento dokument
opisuje filtrovanie, zoraďovanie, počítanie a hlásenie chýb synchronizácie na strane servera,
ktoré poskytuje trasa zoznamu.

## Trasa zoznamu — `GET /api/settings/free-proxies`

Vracia filtrovanú, zoradenú a stránkovanú časť spolu s celkovým počtom. Filtrovanie a
počítanie prebieha v SQL, takže používateľské rozhranie môže zobraziť skutočný celkový počet (napr. `Celkom: 0`)
bez načítania všetkých riadkov do pamäte.

### Parametre dopytu

| Parameter         | Typ                                | Predvolená hodnota | Význam                                                                                                                     |
| ----------------- | ---------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| `search`          | reťazec                            | `""`               | Rozlišovanie veľkých a malých písmen pomocou `LIKE` v stĺpci hostiteľa (a zdroja).                                         |
| `protocol`        | reťazec                            | `""`               | Filter `type`: `http` / `https` / `socks4` / `socks5`. Prázdna hodnota = všetky.                                           |
| `country`         | reťazec                            | `""`               | Filter `countryCode` (ISO-2). Prázdna hodnota = všetky.                                                                    |
| `minQuality`      | číslo                              | `0`                | Iba riadky s `qualityScore >= minQuality`. `0` = bez minimálnej hodnoty.                                                   |
| `disabledSources` | reťazec                            | `""`               | Identifikátory zdrojov oddelené čiarkami, ktoré sa majú vylúčiť (napr. `proxifly,webshare`).                               |
| `sortBy`          | `quality` \| `latency` \| `recent` | `quality`          | `quality` = skóre zostupne; `latency` = latencia vzostupne (nulové hodnoty nakoniec); `recent` = `lastValidated` zostupne. |
| `offset`          | číslo                              | `0`                | Začiatok stránkovania.                                                                                                     |
| `limit`           | číslo                              | `50`               | Veľkosť stránky (obmedzená na strane servera).                                                                             |

### Odpoveď

```json
{
  "success": true,
  "data": {
    "proxies": [/* FreeProxyRecord[] */],
    "total": 137,
    "hasMore": true
  },
  "stats": {
    "total": 137,
    "inPool": 12,
    "avgQuality": 64.2,
    "bySource": [{ "source": "1proxy", "count": 90 }],
    "lastSyncAt": "2026-07-11T09:30:00.000Z"
  },
  "syncErrors": {
    "proxifly": ["HTTP 429 from upstream"],
    "webshare": ["network timeout"]
  }
}
```

`total` predstavuje filtrovaný celkový počet **pred** stránkovaním, takže používateľské rozhranie môže vykresliť
`Celkom: N` a `hasMore` nezávisle od seba. `syncErrors` používa identifikátory zdrojov ako kľúče a
vypĺňa sa iba pre zdroje, ktorých posledná synchronizácia zlyhala — výsledok `Celkom: 0`
nikdy nezostane bez vysvetlenia.

## Pridanie do skupiny — `POST /api/settings/free-proxies/[id]/add-to-pool`

Povýši bezplatný proxy server do spravovanej skupiny `proxy_registry`. Najprv overí
nadradený zdroj; pri úspechu vráti identifikátor nového proxy servera v skupine a nameranú latenciu.

## Synchronizácia — `POST /api/settings/free-proxies/sync`

Znova načíta všetky povolené zdroje (alebo podmnožinu v `{ "sources": [...] }`). Každý
zdroj sa synchronizuje nezávisle; zlyhávajúci zdroj sa zaznamená v `syncErrors` a
ostatné sa napriek tomu dokončia, takže čiastočné synchronizácie nikdy nevymažú predchádzajúce platné údaje.

## Štatistiky — `GET /api/settings/free-proxies/stats`

Vracia súhrn `total / inPool / avgQuality / bySource / lastSyncAt`
bez dátového obsahu riadkov — používa sa v hlavičkových miniaplikáciách ovládacieho panela.