Dokumentation
Proxy-Nutzung
Ein Endpunkt, drei Protokolle. Steuerung über den Benutzernamen.
Endpunkt
Host: proxy.proxinity.one Port: 8000 Protokolle HTTP-Proxy · HTTP CONNECT (HTTPS) · SOCKS5 (Benutzername/Passwort) Ziele TCP 80 und 443
Benutzername
px_<id>[-pool-dc][-country-<cc>][-city-<name>][-asn-<nr>][-session-<id>][-sessttl-<minuten>]
pool-dc– Rechenzentrums-/IPv6-Pool statt Residential (eigener, günstigerer GB-Preis). Ohne Angabe: Residential.country-de– Exit-Node in Deutschland (ISO-3166-Code). Nur verfügbare Länder funktionieren; erlaubte Länder des Zugangs werden durchgesetzt.city-berlin– Stadt (Kleinbuchstaben, Umlaute als ae/oe/ue, Leerzeichen als _ – z. B.city-frankfurt_am_main). Verfügbare Städte: Dashboard → Länder & Targeting oderGET /v1/targets.asn-3320– Internetanbieter (Autonomous System), z. B. Deutsche Telekom = 3320, Vodafone = 3209.session-abc123– Sticky Session: gleiche Node für alle Verbindungen mit dieser ID (1–64 Zeichen, A–Z, 0–9, _).sessttl-15– Dauer der Sticky Session in Minuten, begrenzt durch Tarif und Plattformeinstellung.
Beispiele
curl -x http://px_xxxxxxxxxx-country-de:[email protected]:8000 https://api.ipify.org curl -x socks5h://px_xxxxxxxxxx-session-cart7-sessttl-10:[email protected]:8000 https://example.com
# Python (requests)
proxies = {"https": "http://px_xxxxxxxxxx-country-nl:[email protected]:8000"}
requests.get("https://example.com", proxies=proxies, timeout=30)// Node.js (undici)
import { ProxyAgent, fetch } from "undici";
const dispatcher = new ProxyAgent("http://px_xxxxxxxxxx:[email protected]:8000");
await fetch("https://example.com", { dispatcher });Antwortcodes des Gateways
407– Zugangsdaten fehlen oder sind falsch (wiederholte Fehlversuche sperren die Client-IP vorübergehend).402– Guthaben aufgebraucht oder Traffic-Limit des Zugangs erreicht.403– Ziel, Port oder Land nicht erlaubt bzw. Zugang/Konto gesperrt.429– Verbindungsrate oder gleichzeitige Verbindungen überschritten, oder Drosselung durch Missbrauchsschutz.503– Aktuell keine passende Node verfügbar.502/504– Ziel nicht erreichbar bzw. Node hat nicht rechtzeitig geantwortet.
Bei SOCKS5 werden die entsprechenden RFC-1928-Antwortcodes verwendet (z. B. 0x02 nicht erlaubt, 0x03 Netz nicht erreichbar).
Verbindung testen
Im Dashboard unter „Proxy-Zugänge“ führt „Testen“ einen echten Request über eine echte Node aus und zeigt Exit-IP, Land und Latenz an. Der Test-Traffic wird wie normaler Traffic abgerechnet.