Koneksi dan ganti IP

Bagian pertama membahas Residential. Alamat tetap dihubungkan dengan cara lain: bagian tersendiri di bawah.

Baris koneksi

Respons POST /api/v1/packages/{id}/proxies memuat host, port, username, password.

Login adalah string siap pakai: penargetan dan mode dikodekan di dalamnya, jangan menyusunnya sendiri.

Port mengodekan mode dan protokol, jangan mengubahnya.

residential.ipv.rent:10000:USERNAME:PASSWORD          # browser antidetect, manajer proxy
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

Mode dan protokol

Mode	Perilaku
rotating	alamat baru pada setiap koneksi
sticky	alamat bertahan selama ttl_minutes: 3..1440, default 60

Port untuk setiap pasangan (mode, protokol) ada di connection_options pada kartu paket:

Mode	HTTP	SOCKS5
rotating	9000	11000
sticky	10000	12000

Protokol email (SMTP, IMAP, POP3) dan UDP tidak didukung.

Penargetan

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

Nilainya adalah kode dari katalog geo.

• Tingkat bersifat opsional: tanpa geo - pool global.
• state, city, dan asn memerlukan country.
• Di bawah tingkat negara, penargetan dilakukan sebisa mungkin: jika di wilayah, kota, atau operator yang diminta tidak ada alamat yang tersedia, alamat keluar diberikan dari lokasi lain di negara yang sama.

Nilai di luar katalog, kunci yang tidak dikenal, atau penyempitan tanpa negara - 422 invalid_targeting dengan field dan value.

Ganti IP

Dalam mode rotating, alamat berganti dengan sendirinya.

Setiap baris sticky punya tautan rotation_url sendiri: GET ke tautan itu melepas alamat saat ini, koneksi berikutnya akan mendapat alamat lain. Otorisasi tidak diperlukan.

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

HTTP	status	Arti
200	ok	alamat dilepas
200	not_in_use	tidak ada sesi aktif; koneksi berikutnya tetap akan memberi alamat baru
200	unconfirmed	permintaan terkirim, belum ada konfirmasi
404	not_found	tautan tidak berlaku
410	expired	sumber daya tautan sudah kedaluwarsa; tidak terjadi pada paket trafik
429	rate_limited	terlalu sering
503	error	alamat gagal diganti

Batas: 20 permintaan per menit per alamat, 120 per paket, 300 per IP pemanggil. Satu tautan tidak bisa dicabut sendiri - POST /api/v1/packages/{id}/rotation-secret membatalkan semuanya sekaligus.

Alamat tetap

Paket IPv4 adalah daftar alamat siap pakai. Baris tidak perlu dibuat: semuanya ada di kartu GET /api/v1/packages/{id}.

Apa	Di mana
alamat	addresses[].host
port HTTP	addresses[].port_http
port SOCKS5	addresses[].port_socks
login dan kata sandi	credentials - satu untuk semua alamat paket

198.51.100.11:10010:USERNAME:PASSWORD             # browser antidetect, manajer proxy
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

• Alamat keluar adalah alamat dari daftar itu sendiri, dan tidak berubah selama seluruh periode.
• UDP berfungsi melalui SOCKS5 - untuk game, panggilan, dan layanan berbasis QUIC.
• Tidak ada penargetan dan tautan ganti IP: negara dan lokasi dipilih saat pembelian.
• Alamat baru bisa didapat dengan penggantian - semua alamat paket sekaligus, sekali setiap 30 hari.
• Protokol email (SMTP, IMAP, POP3) tidak didukung.

Jika tidak berfungsi

Gejala	Penyebab
autentikasi ditolak setelah set dibuat	kata sandi paket diterbitkan ulang
berhenti berfungsi di semua worker sekaligus	volume habis, periksa traffic.left_gb
alamat tidak berasal dari geo yang diminta	di lokasi yang diminta tidak ada alamat yang tersedia, diberikan lokasi lain di negara yang sama; negara seperti ini ditandai pool: thin di katalog geo - pilih tingkat yang lebih tinggi
422 package_unavailable saat membuat set	paket belum diberikan (tunggu status: active), ttl_minutes di luar 3..1440, atau mode atau protokol tidak didukung paket
alamat tetap tidak merespons tepat setelah pembelian	paket diberikan dalam waktu hingga 2 menit
semua alamat tetap berhenti merespons sekaligus	masa berlaku habis: status: expired, perpanjang paket
autentikasi ditolak pada alamat tetap	kata sandi diterbitkan ulang, atau paket diperpanjang setelah masa berlaku habis dan kata sandi baru diterbitkan - ambil credentials dari kartu
alamat tetap yang lama tidak berfungsi	alamat sudah diganti: replacement.state: done, yang baru - di addresses