Files
OmniRoute/docs/i18n/de/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 (Deutsch)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇬🇷 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 · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW


OmniRoute wird mit einem kuratierten Pool kostenloser Proxys in der Tabelle free_proxies ausgeliefert, der mit externen Anbietern (1proxy, proxifly, iplocate, webshare) synchronisiert wird. Das Dashboard zeigt diese unter Einstellungen → Kostenlose Proxys an. Dieses Dokument beschreibt die serverseitige Filterung, Sortierung, Zählung und Meldung von Synchronisierungsfehlern, die von der Listenroute bereitgestellt werden.

Listenroute — GET /api/settings/free-proxies

Gibt einen gefilterten, sortierten und paginierten Ausschnitt sowie die Gesamtanzahl zurück. Filterung und Zählung erfolgen in SQL, sodass die Benutzeroberfläche die tatsächliche Gesamtanzahl (z. B. Gesamt: 0) anzeigen kann, ohne jede Zeile in den Arbeitsspeicher laden zu müssen.

Abfrageparameter

Parameter Typ Standardwert Bedeutung
search Zeichenfolge "" Groß-/Kleinschreibung berücksichtigendes LIKE für die Host- und Quellspalte.
protocol Zeichenfolge "" type-Filter: http / https / socks4 / socks5. Leer = alle.
country Zeichenfolge "" countryCode-Filter (ISO-2). Leer = alle.
minQuality Zahl 0 Nur Zeilen mit qualityScore >= minQuality. 0 = keine Untergrenze.
disabledSources Zeichenfolge "" Durch Kommas getrennte auszuschließende Quell-IDs (z. B. proxifly,webshare).
sortBy quality | latency | recent quality quality = Bewertung absteigend; latency = Latenz aufsteigend (Nullwerte zuletzt); recent = lastValidated absteigend.
offset Zahl 0 Beginn der Paginierung.
limit Zahl 50 Seitengröße (serverseitig begrenzt).

Antwort

{
  "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 gibt die gefilterte Gesamtanzahl vor der Paginierung an, sodass die Benutzeroberfläche Gesamt: N und hasMore unabhängig voneinander darstellen kann. syncErrors ist nach Quell-ID strukturiert und wird nur für Quellen befüllt, deren letzte Synchronisierung fehlgeschlagen ist — ein Ergebnis von Gesamt: 0 bleibt niemals ohne Fehlermeldung.

Zum Pool hinzufügen — POST /api/settings/free-proxies/[id]/add-to-pool

Überführt einen kostenlosen Proxy in den verwalteten Pool proxy_registry. Validiert zunächst den Upstream; bei Erfolg werden die neue Pool-Proxy-ID und die gemessene Latenz zurückgegeben.

Synchronisierung — POST /api/settings/free-proxies/sync

Ruft alle aktivierten Quellen erneut ab (oder die Teilmenge in { "sources": [...] }). Jede Quelle wird unabhängig synchronisiert; eine fehlgeschlagene Quelle wird in syncErrors erfasst, während die anderen dennoch abgeschlossen werden, sodass Teilsynchronisierungen niemals zuvor gültige Daten löschen.

Statistiken — GET /api/settings/free-proxies/stats

Gibt das Aggregat total / inPool / avgQuality / bySource / lastSyncAt ohne die Zeilendaten zurück — es wird von den Header-Widgets des Dashboards verwendet.