API für Residential Proxys
Wir bieten Residential Proxys mit Abrechnung nach Datenvolumen an. Damit die API korrekt funktioniert, müssen Sie Datenvolumen für Residential Proxys kaufen. Wenn Ihr Datenvolumen aufgebraucht ist, funktionieren einige Anfragen nicht mehr.
API-Anfragen
Für die Nutzung der API ist ein Schlüssel erforderlich. Diesen finden Sie auf der Seite Profil.
Allgemeines Anfrageformat:
https://thesafety.us/getapi?key=[API ключ]&act=[имя запроса]
Verbleibendes Datenvolumen
Verwenden Sie act=traffic, um das verbleibende Datenvolumen zu prüfen
https://thesafety.us/getapi?key=[API ключ]&act=traffic
Die Antwort erfolgt im XML-Format.
Das Feld auth = true, wenn der API-Schlüssel korrekt ist.
Das Feld resident-traffic-in-mb zeigt das verbleibende Datenvolumen in Megabyte an.
Liste der Länder, Städte und Bundesstaaten
Die aktuelle Liste erhalten Sie mit act=countries
https://thesafety.us/getapi?key=[API ключ]&act=countries
Die Antwort erfolgt im XML-Format.
Das Feld auth = true, wenn der API-Schlüssel korrekt ist.
Das Feld resident enthält die Tags country (vollständiger Ländername) und code (Ländercode). Für die API muss code (Ländercode) angegeben werden.
Für einige Länder sind Städte im Tag city und Bundesstaaten im Tag state angegeben. Städte und Bundesstaaten werden als durch Kommas getrennte Liste angegeben.
Proxy-Liste generieren
Die Proxy-Liste erhalten Sie über act=getresproxy
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy
Die Antwort erfolgt im Format text/plain. Diese Anfrage liefert einen Proxy mit dynamischer IP-Adresse für ein beliebiges Land. Land und IP-Adresse werden bei jeder Anfrage zufällig ausgewählt.
Zusätzliche Parameter:
| Parameter | Kommentar |
|---|---|
| &base= | Proxy-Pool:
Diesen Parameter können Sie mit der Anfrage act=countries ermitteln Wenn es nur einen Proxy-Pool gibt, kann der Parameter entfallen. |
| &type= | Proxy-Typ:
http = HTTP/HTTPS-Proxy socks5 = Socks5-Proxy Wenn type nicht angegeben ist, wird standardmäßig http verwendet. |
| $list= | Format der Proxy-Liste:
hpup = hostname:port:username:password hp@up = hostname:port@username:password uphp = username:password:hostname:port up@hp = username:password@hostname:port Wenn list nicht angegeben ist, wird standardmäßig hpup verwendet. |
| Land, Stadt und Bundesstaat auswählen | |
| &country= | Zweistelliger Ländercode [Parameter code aus der Anfrage act=countries] |
| &city= | Name der Stadt [Parameter city aus der Anfrage act=countries]
Das System versucht, IP-Adressen am angegebenen Standort bereitzustellen, dies wird jedoch nicht garantiert. Nicht gleichzeitig mit folgendem Parameter verwenden: &state= Funktioniert nur zusammen mit der Angabe des Landes &country= |
| &state= | Name des Bundesstaats [Parameter state aus der Anfrage act=countries]
Das System versucht, IP-Adressen am angegebenen Standort bereitzustellen, dies wird jedoch nicht garantiert. Nicht gleichzeitig mit folgendem Parameter verwenden: &city= Funktioniert nur zusammen mit der Angabe des Landes &country= |
| Abrufen einer statischen IP-Adresse | |
| &session=1 | Gibt an, dass eine statische IP-Adresse verwendet werden soll, die im Proxy-Passwort über den Parameter session festgelegt wird.
Wenn session nicht angegeben ist, wird immer 1 Proxy mit dynamischer IP-Adresse ausgegeben, die sich bei jeder Anfrage ändert. Der Wechsel der IP-Adresse erfolgt auf dem Proxyserver und erfordert keine zusätzlichen Einstellungen durch den Benutzer. |
| &amount= | Gibt die gewünschte Anzahl der zu generierenden Proxys an.
Mögliche Werte von 1 bis 1000. Funktioniert nur zusammen mit dem Parameter &session=1 |
| &lifetime= | Zeit, nach der die statische IP-Adresse durch eine neue ersetzt wird.
Mögliche Parameter in Sekunden, Minuten und Stunden: 5-59s, 1-59m, 1-24h Beispiel: 30s - die IP-Adresse alle 30 Sekunden ändern 10m – IP-Adresse alle 10 Minuten ändern 6h – IP-Adresse alle 6 Stunden ändern Das System versucht, entsprechend dem angegebenen Parameter zu arbeiten, dies wird jedoch nicht garantiert.
Funktioniert nur zusammen mit dem Parameter &session=1 |
Beispielanfragen:
Liste mit 10 HTTP/HTTPS-Proxys mit statischer IP-Adresse in Deutschland im Format up@hp
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=de&type=http&list=up@hp&session=1&amount=10
Socks5-Proxy mit dynamischer IP-Adresse in den USA im Format hpup
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&type=socks5&list=hpup
HTTP/HTTPS-Proxy mit dynamischer IP-Adresse in den USA, Bundesstaat Utah
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&state=utah
HTTP/HTTPS-Proxy mit dynamischer IP-Adresse in Kanada, Stadt Montreal
https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=ca&city=montreal
Haben Sie Vorschläge zur Verbesserung der API? Kontaktieren Sie uns.