Bağlantı ve IP değiştirme

İlk bölümler Residential hakkındadır. Sabit adreslere bağlantı farklıdır: aşağıdaki ayrı bölüme bakın.

Bağlantı satırı

POST /api/v1/packages/{id}/proxies yanıtında host, port, username, password gelir.

Kullanıcı adı hazır bir dizedir: hedefleme ve mod onun içine kodlanmıştır, kendiniz oluşturamazsınız.

Port, modu ve protokolü kodlar; değiştirilemez.

residential.ipv.rent:10000:USERNAME:PASSWORD          # antidetect tarayıcılar, proxy yöneticileri
http://USERNAME:[email protected]:10000   # curl, requests, Node, Go
socks5://USERNAME:[email protected]:12000

curl -x 'http://USERNAME:[email protected]:10000' https://api.ipify.org

Modlar ve protokoller

Mod	Davranış
`rotating`	her bağlantıda yeni adres
`sticky`	adres `ttl_minutes` boyunca tutulur: 3..1440, varsayılan 60

Her (mod, protokol) çiftinin portu paket kartındaki connection_options içinde gelir:

Mod	HTTP	SOCKS5
`rotating`	9000	11000
`sticky`	10000	12000

E-posta protokolleri (SMTP, IMAP, POP3) ve UDP desteklenmez.

Hedefleme

{
  "count": 10,
  "geo": {
    "country": "us",
    "state": "california",
    "city": "los angeles"
  }
}

Değerler geo kataloğundaki kodlardır.

Seviyeler isteğe bağlıdır: geo olmadan küresel havuz kullanılır.
state, city ve asn için country gerekir.
Ülkenin altındaki hedefleme mümkün olduğunca uygulanır: istenen bölgede, şehirde veya operatörde müsait adres yoksa çıkış aynı ülkenin başka bir konumundan verilir.

Katalog dışı değer, bilinmeyen anahtar veya ülkesiz daraltma - field ve value ile 422 invalid_targeting.

IP değiştirme

rotating modunda adres kendiliğinden değişir.

Her sticky satırının kendi rotation_url bağlantısı vardır: ona yapılan GET mevcut adresi serbest bırakır, sonraki bağlantı başka bir adres alır. Yetkilendirme gerekmez.

curl -s https://ipv.rent/r/9f3c1e...

HTTP	`status`	Anlamı
200	`ok`	adres serbest bırakıldı
200	`not_in_use`	etkin oturum yok; sonraki bağlantı yine de yeni adres verir
200	`unconfirmed`	istek gönderildi, onay yok
404	`not_found`	bağlantı geçerli değil
410	`expired`	bağlantının kaynağının süresi doldu; trafik paketlerinde oluşmaz
429	`rate_limited`	çok sık
503	`error`	adres değiştirilemedi

Limitler: adres başına dakikada 20 istek, paket başına 120, çağıranın IP’si başına 300. Tek bir bağlantı iptal edilemez - POST /api/v1/packages/{id}/rotation-secret hepsini aynı anda geçersiz kılar.

Sabit adresler

IPv4 paketi hazır bir adres listesidir. Satır oluşturmanız gerekmez: her şey GET /api/v1/packages/{id} kartındadır.

Ne	Nereden alınır
adresler	`addresses[].host`
HTTP portu	`addresses[].port_http`
SOCKS5 portu	`addresses[].port_socks`
kullanıcı adı ve parola	`credentials` - paketin tüm adresleri için tek

198.51.100.11:10010:USERNAME:PASSWORD             # antidetect tarayıcılar, proxy yöneticileri
http://USERNAME:[email protected]:10010      # curl, requests, Node, Go
socks5://USERNAME:[email protected]:10011

curl -x 'http://USERNAME:[email protected]:10010' https://api.ipify.org

Çıkış adresi listedeki adresin kendisidir ve tüm süre boyunca değişmez.
UDP, SOCKS5 üzerinden çalışır - oyunlar, aramalar ve QUIC tabanlı hizmetler için.
Hedefleme ve IP değiştirme bağlantıları yoktur: ülke ve konum satın alırken seçilir.
Yeni adresleri değişimle alabilirsiniz - paketin tüm adresleri birden, 30 günde bir.
E-posta protokolleri (SMTP, IMAP, POP3) desteklenmez.

Çalışmadığında

Belirti	Neden
küme oluşturulduktan sonra kimlik doğrulama reddi	paketin parolası yenilendi
tüm worker’larda aynı anda durdu	hacim tükendi, `traffic.left_gb` değerini kontrol edin
adres istenen coğrafyadan değil	istenen konumda müsait adres yok, aynı ülkenin başka bir konumu verildi; geo kataloğu bu ülkeleri `pool: thin` ile işaretler - bir üst seviyeyi seçin
küme oluştururken 422 `package_unavailable`	paket henüz verilmedi (`status: active` bekleyin), `ttl_minutes` 3..1440 dışında ya da mod veya protokol paket tarafından desteklenmiyor
sabit adresler satın alımdan hemen sonra yanıt vermiyor	paketin verilmesi 2 dakikaya kadar sürer
sabit adreslerin hepsi aynı anda yanıt vermeyi bıraktı	süre doldu: `status: expired`, paketi uzatın
sabit adreslerde kimlik doğrulama reddi	parola yenilendi ya da paket süre bittikten sonra uzatıldı ve yeni parola verildi - `credentials` değerini karttan alın
eski sabit adresler çalışmıyor	adresler değiştirildi: `replacement.state: done`, yenileri `addresses` içinde