Kết nối và đổi IP

Các phần đầu nói về Residential. Địa chỉ cố định được kết nối theo cách khác: phần riêng bên dưới.

Chuỗi kết nối

Phản hồi của POST /api/v1/packages/{id}/proxies trả về host, port, username, password.

Tên đăng nhập là một chuỗi sẵn dùng: nhắm mục tiêu và chế độ được mã hóa trong đó, không được tự ghép nó.

Cổng mã hóa chế độ và giao thức, không được thay đổi nó.

residential.ipv.rent:10000:USERNAME:PASSWORD          # trình duyệt antidetect, trình quản lý 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

Chế độ và giao thức

Chế độ	Hành vi
rotating	địa chỉ mới cho mỗi kết nối
sticky	địa chỉ được giữ trong ttl_minutes: 3..1440, mặc định 60

Cổng của mỗi cặp (chế độ, giao thức) có trong connection_options của thẻ gói:

Chế độ	HTTP	SOCKS5
rotating	9000	11000
sticky	10000	12000

Các giao thức thư (SMTP, IMAP, POP3) và UDP không được hỗ trợ.

Nhắm mục tiêu

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

Giá trị là mã từ danh mục địa lý.

• Các cấp là tùy chọn: không có geo - nhóm địa chỉ toàn cầu.
• state, city và asn yêu cầu country.
• Dưới cấp quốc gia, nhắm mục tiêu được thực hiện trong khả năng có thể: nếu khu vực, thành phố hoặc nhà mạng được yêu cầu không còn địa chỉ trống, đầu ra được cấp từ một vị trí khác trong cùng quốc gia.

Giá trị ngoài danh mục, khóa không xác định hoặc thu hẹp mà không có quốc gia - 422 invalid_targeting với field và value.

Đổi IP

Ở chế độ rotating, địa chỉ tự thay đổi.

Mỗi chuỗi sticky có liên kết rotation_url riêng: GET tới liên kết đó giải phóng địa chỉ hiện tại, kết nối tiếp theo sẽ nhận địa chỉ khác. Không cần xác thực.

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

HTTP	status	Ý nghĩa
200	ok	địa chỉ đã được giải phóng
200	not_in_use	không có phiên đang hoạt động; kết nối tiếp theo vẫn sẽ cho địa chỉ mới
200	unconfirmed	yêu cầu đã được gửi, chưa có xác nhận
404	not_found	liên kết không còn hiệu lực
410	expired	tài nguyên của liên kết đã hết hạn; không xảy ra với gói lưu lượng
429	rate_limited	quá thường xuyên
503	error	không đổi được địa chỉ

Giới hạn: 20 yêu cầu mỗi phút cho mỗi địa chỉ, 120 cho mỗi gói, 300 cho mỗi IP của bên gọi. Không thể thu hồi riêng một liên kết - POST /api/v1/packages/{id}/rotation-secret vô hiệu hóa tất cả cùng lúc.

Địa chỉ cố định

Gói IPv4 là một danh sách địa chỉ sẵn dùng. Không cần tạo chuỗi: mọi thứ đều có trong thẻ GET /api/v1/packages/{id}.

Gì	Lấy ở đâu
địa chỉ	addresses[].host
cổng HTTP	addresses[].port_http
cổng SOCKS5	addresses[].port_socks
tên đăng nhập và mật khẩu	credentials - dùng chung cho mọi địa chỉ của gói

198.51.100.11:10010:USERNAME:PASSWORD             # trình duyệt antidetect, trình quản lý 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

• Địa chỉ đầu ra chính là địa chỉ trong danh sách, nó không thay đổi trong suốt thời hạn.
• UDP hoạt động qua SOCKS5 - cho game, cuộc gọi và các dịch vụ dùng QUIC.
• Không có nhắm mục tiêu và liên kết đổi IP: quốc gia và vị trí được chọn khi mua.
• Có thể nhận địa chỉ mới bằng cách thay thế - toàn bộ địa chỉ của gói cùng lúc, mỗi 30 ngày một lần.
• Các giao thức thư (SMTP, IMAP, POP3) không được hỗ trợ.

Nếu không hoạt động

Triệu chứng	Nguyên nhân
lỗi xác thực sau khi tạo bộ chuỗi	mật khẩu của gói đã được cấp lại
ngừng hoạt động ở mọi worker cùng lúc	dung lượng đã dùng hết, hãy kiểm tra traffic.left_gb
địa chỉ không thuộc vị trí địa lý được yêu cầu	vị trí được yêu cầu không còn địa chỉ trống, đã cấp vị trí khác trong cùng quốc gia; danh mục địa lý đánh dấu những quốc gia này là pool: thin - hãy chọn cấp cao hơn
422 package_unavailable khi tạo bộ chuỗi	gói chưa được cấp (chờ status: active), ttl_minutes nằm ngoài 3..1440, hoặc gói không hỗ trợ chế độ hay giao thức đó
địa chỉ cố định không phản hồi ngay sau khi mua	gói được cấp trong tối đa 2 phút
mọi địa chỉ cố định cùng ngừng phản hồi	đã hết hạn: status: expired, hãy gia hạn gói
lỗi xác thực trên địa chỉ cố định	mật khẩu đã được cấp lại, hoặc gói được gia hạn sau khi hết hạn và mật khẩu mới đã được cấp - hãy lấy credentials từ thẻ gói
địa chỉ cố định cũ không hoạt động	địa chỉ đã được thay: replacement.state: done, địa chỉ mới - trong addresses