Residential-Proxy
Aktualisiert:
Verwalten Sie Residential-Proxy-Pakete, Listen und Sitzungen programmgesteuert.
Ein Paket ist Ihr Abonnement – es verfügt über ein Datenvolumenlimit und ein Ablaufdatum. Innerhalb eines Pakets erstellen Sie Listen: benannte Bündel von IP-Adressen, die nach geografischen Kriterien und Rotationsregeln gefiltert sind. Sie stellen über den Benutzernamen und das Passwort der Liste eine Verbindung zum Proxy her, und ein Paket kann viele Listen für verschiedene Anwendungsfälle enthalten.
Listen
Proxy-Listen erstellen, konfigurieren und entfernen
Lesen
Schreiben
Paket
Weitere Steuerelemente
Gilt für alle Endpunkte im Wohnbereich
Basis-URL
https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/Authentifizierung
API-Schlüssel im URL-Pfad – protokolliere niemals vollständige Anfrage-URLs.
Fehlermodell
Geschäftliche Fehler führen zu einem HTTP-Status 200 mit ausgefüllten Fehlerfeldern [].
Nachdem Sie Ihre Proxys konfiguriert haben
Cases (FAQ)common scenarios and troubleshootingOpenBalancecheck funds before extending trafficOpenFAQ
Paket — Ihr Abonnement (Datenvolumen + Ablaufdatum). Liste — ein benanntes Login-/Passwort-Paket mit Geo- und Whitelist-Filtern, das in einem Paket enthalten ist. Sitzung — kurzlebige Zuordnung einer bestimmten Ausgangs-IP-Adresse zu einer einzelnen Verbindung, die spontan über _s_… Suffix beim Login.
Auf Paketebene. Eine Liste besteht lediglich aus Anmeldedaten und einem Filter; consumption-cost Die Abrechnung erfolgt nach Login (d. h. pro Liste), die tatsächlichen Abbuchungen gehen jedoch auf das Paketguthaben zu Lasten.
Jeder Port weist eine eigene Ausgangs-IP-Adresse auf – nutzen Sie diese parallel für gleichzeitige Anfragen. Ein Port = eine Ausgangs-IP-Adresse zu einem bestimmten Zeitpunkt.
Eine Liste in Ihrem Hauptpaket stellt Ihnen ein „credentials/filter“-Bundle zur Verfügung – dessen Datenverkehr teilt sich jedoch den Pool des Pakets ohne Obergrenze. Ein Unterpaket reserviert sich einen festen Datenverkehrsanteil (traffic_limit) mit eigener Ablaufzeit und eigenem Ein-/Aus-Schalter und gibt bei Löschung nicht genutzten Datenverkehr an das übergeordnete Paket zurück. Listen, die Sie darin erstellen, funktionieren auf die gleiche Weise – sie werden lediglich über den Datenverkehrsanteil des Unterpakets abgerechnet.
Verwenden Sie ein Unterpaket, wenn Sie eine feste Traffic-Obergrenze für jemanden (einen Client, ein Team, eine Kampagne) benötigen – ohne Ihren API-Schlüssel preiszugeben. Die gesamte Verwaltung erfolgt weiterhin über Ihren eigenen Schlüssel. Verwenden Sie eine einfache Liste, wenn Sie lediglich eine Isolierung von Anmeldedaten oder geografische Isolierung innerhalb Ihrer eigenen Quote benötigen.
Ja: https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/.... Varianten von Subuser verwenden /residentsubuser/....
HTTP und SOCKS5 auf demselben Host, denselben Ports, mit denselben Anmeldedaten – das Gateway erkennt das Protokoll automatisch. SOCKS5 unterstützt auch UDP, sodass Sie Websites über HTTP/3 (QUIC) über den Proxy aufrufen können; siehe HTTP/3 & UDP über SOCKS5. Eine Verbindung zum Proxy selbst über HTTPS wird nicht unterstützt.
Die programmgesteuerte Verlängerung eines Wohnpakets wird in der öffentlichen API nicht unterstützt. /extend-proxies (/prolong/calc/{type}, /prolong/make/{type}) akzeptiert nur IP-basierte Typen — ipv4, ipv6, mobile, isp, mix, mix_isp. resident ist nicht in dieser Liste enthalten und es gibt kein /resident/prolong Endpunkt.
Verlängern Sie das Wohnpaket über das Dashboard, bevor expired_at gemeldet von get-package-information. Das genaue Verhalten bei Ablauf (aktive Verbindungen, Übertragung nicht genutzter Daten) ist in der API-Spezifikation nicht dokumentiert – erkundigen Sie sich beim Support, ob dies für Ihre Integration von Bedeutung ist.