Files
OmniRoute/docs/i18n/sk/docs/reference/FREE_PROXIES_API.md
Diego Rodrigues de Sa e Souza 8feea123bb feat(docs): mirror every docs/ page in all 65 locales (#14106)
* feat(docs): mirror every docs/ page in all 65 locales

Extends the documentation mirrors from the 22-page core set (#13940) to
every Markdown page under docs/: 152 sources x 65 locales = 9,880 mirrors
(6,208 new), language bars rewritten for the full locale list, state
adopted so the blocking drift gate now covers all 152 pages.

run-translation.mjs: an oversized block made only of table rows or list
items (PROVIDER_REFERENCE.md 244-row table, FREE_TIERS.md 71-item list) is
cut at item boundaries and rejoined without a blank line — the single
16-40 KB request outlived the backend socket for verbose scripts. 48
older mirrors whose tables had lost rows were retranslated with --force.

* docs(i18n): refresh mirrors for the sources the base changed since the branch cut

Section-level retranslation of the 29 docs (and README.md) whose source
or mirrors moved on release/v3.8.51 during the run, then state adoption;
the drift gate is green again on the merged tree.
2026-09-18 13:16:46 -03:00

8.6 KiB

Free Proxies API (Slovenčina)

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


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ď

{
  "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.