Konut proxyleri API'si

Trafiğe göre ücretlendirilen konut proxy'leri sunuyoruz. API'nin doğru çalışması için konut proxy trafiği satın al. Trafiğiniz biterse bazı istekler çalışmaz.


API istekleri

API kullanımı için anahtar gerekir. Anahtarı şu sayfada bulabilirsiniz: Profil.

Genel istek biçimi:

https://thesafety.us/getapi?key=[API ключ]&act=[имя запроса]


Kalan trafik

Kalan trafiği kontrol etmek için act=traffic kullanın

https://thesafety.us/getapi?key=[API ключ]&act=traffic

Yanıt XML biçiminde olacaktır.

API anahtarı doğruysa auth = true olur.

resident-traffic-in-mb alanı kalan trafiği megabayt cinsinden gösterir.



Ülke, şehir ve eyalet listesi

Güncel liste act=countries ile alınabilir

https://thesafety.us/getapi?key=[API ключ]&act=countries

Yanıt XML biçiminde olacaktır.

API anahtarı doğruysa auth = true olur.

resident alanı country (ülkenin tam adı) ve code (ülke kodu) etiketlerini içerir. API için code (ülke kodu) belirtilmelidir.

Bazı ülkelerde şehirler city, eyaletler state etiketinde belirtilir. Şehirler ve eyaletler virgülle ayrılmış listeler halinde verilir.



Proxy listesi oluşturma

Proxy listesi act=getresproxy ile alınabilir

https://thesafety.us/getapi?key=[API ключ]&act=getresproxy

Yanıt text/plain biçiminde olacaktır. Bu istek, herhangi bir ülkeden dinamik IP adresli bir proxy verir. Ülke ve IP adresi her istekte rastgele seçilir.


Ek parametreler:

Parametre Açıklama
&base= Proxy veritabanı:
Bu parametre act=countries isteğinden alınabilir
Tek bir proxy veritabanı varsa parametre bulunmayabilir.
&type= Proxy türü:
http = HTTP/HTTPS proxy
socks5 = Socks5 proxy
type belirtilmezse varsayılan olarak http kullanılır.
$list= Proxy listesi biçimi:
hpup = hostname:port:username:password
hp@up = hostname:port@username:password
uphp = username:password:hostname:port
up@hp = username:password@hostname:port
list belirtilmezse varsayılan olarak hpup kullanılır.
Ülke, şehir ve eyalet seçimi
&country= 2 harfli ülke kodu [act=countries isteğindeki code parametresi]
&city= Şehir adı [act=countries isteğindeki city parametresi]
Sistem belirtilen konumdan IP sağlamaya çalışır, ancak bunu garanti etmez.
Şu parametreyle aynı anda kullanmayın &state=
Yalnızca ülke belirtildiğinde çalışır &country=
&state= Eyalet adı [act=countries isteğindeki state parametresi]
Sistem belirtilen konumdan IP sağlamaya çalışır, ancak bunu garanti etmez.
Şu parametreyle aynı anda kullanmayın &city=
Yalnızca ülke belirtildiğinde çalışır &country=
Statik IP adresi alma
&session=1 Proxy parolasında session parametresiyle tanımlanan statik IP adresinin kullanılmasını belirtir.
session belirtilmezse her zaman her istekte değişen dinamik IP adresli 1 proxy verilir. IP değişikliği proxy sunucusunda yapılır ve kullanıcının ek ayar yapmasını gerektirmez.
&amount= Oluşturulacak proxy sayısını belirtir.
Olası değerlerin başlangıcı 1 kadar 1000.
Yalnızca şu parametreyle birlikte çalışır: &session=1
&lifetime= Statik IP adresinin yenisiyle değiştirileceği süre.
Saniye, dakika ve saat cinsinden olası değerler: 5-59s, 1-59m, 1-24h
Örnek:
30s - IP adresini 30 saniyede bir değiştir
10m - IP adresini 10 dakikada bir değiştir
6h - IP adresini her 6 saatte bir değiştir
Sistem belirtilen parametreye uymaya çalışır, ancak bu garanti edilmez.
Yalnızca şu parametreyle birlikte çalışır: &session=1


İstek örnekleri:

Almanya'da statik IP adresli 10 HTTP/HTTPS proxy'nin up@hp biçimindeki listesi

https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=de&type=http&list=up@hp&session=1&amount=10

ABD'de dinamik IP adresli Socks5 proxy'leri, hpup biçiminde

https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&type=socks5&list=hpup

ABD, Utah eyaletinde dinamik IP adresli HTTP/HTTPS proxy

https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=us&state=utah

Kanada'nın Montreal şehrinde dinamik IP adresli HTTP/HTTPS proxy

https://thesafety.us/getapi?key=[API ключ]&act=getresproxy&country=ca&city=montreal



API'yi geliştirmeye yönelik öneriniz mi var? Bize ulaşın.




Bize sorun