Tái sử dụng Proxy cho nhiều Request
Tìm hiểu cách giữ nguyên proxy exit qua các request tiếp theo, giúp quá trình render JavaScript, gọi API và fetch phân trang đều xuất phát từ cùng một IP.
Tại sao nên tái sử dụng proxy
Khi bạn gửi request đầu tiên đến mục tiêu, FourA sẽ chọn một proxy hoạt động tốt cho bạn. Response từ Proxy hoặc Auto sẽ bao gồm proxy ID đã sử dụng. Gửi lại ID đó trong các request tiếp theo và:
- Các trang tiếp theo sẽ đi qua cùng một exit, giúp session cookie và rate limit luôn nhất quán đối với mục tiêu.
- Lượt fetch theo phạm vi quốc gia vẫn nằm trong allowlist của bạn mà không cần chọn lại từ đầu.
- Endpoint
POST /api/single/chi phí thấp sẽ phát lại qua proxy bạn đã trả phí để khám phá, với mức phí của Single thay vì Proxy.
Proxy ID là một chuỗi base36 bí mật (dạng như A1B2C3). Tuyệt đối không phải là IP thô.
Vị trí của ID trong Response
| Endpoint | Field | When it's present |
|---|---|---|
POST /api/auto/ |
session.proxy |
Khi returnSession là true (mặc định) |
POST /api/single/ |
proxy (cấp cao nhất) |
Chỉ khi request cung cấp trường proxy |
POST /api/proxy/ |
proxy (cấp cao nhất) |
Luôn có, khi thành công |
POST /api/browser/ |
proxy (cấp cao nhất) |
Chỉ khi request cung cấp trường proxy |
Để nhận một exit mới mà không ghim cố định, hãy bắt đầu với Auto hoặc Proxy. Cả hai đều tìm kiếm một exit đang hoạt động và trả về ID của nó cho bạn.
Mô hình 1: Auto khám phá, Single phát lại
Hiệu quả nhất khi bạn gặp một mục tiêu chưa từng xử lý trước đây. Auto duyệt qua các cấp độ một lần, sau đó Single tái sử dụng session thành công đó cho mọi trang tiếp theo.
import requests
API = "https://eu.api.foura.ai"
H = {"X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"}
# Step 1: discover a working exit with Auto.
r = requests.post(f"{API}/api/auto/", headers=H, json={
"url": "https://example.com/product/42",
"validate": {"data": {"accept": ["Add to cart"]}}
}).json()
session = r.get("session") or {}
proxy = session.get("proxy")
user_agent = session.get("userAgent")
# Step 2: paginate with Single, reusing the same exit, User-Agent and cookies.
for sku in ("43", "44", "45"):
body = {"method": "GET", "url": f"https://example.com/product/{sku}"}
if proxy:
body["proxy"] = proxy
headers = []
if user_agent:
headers.append(["User-Agent", user_agent])
if session.get("cookies"):
headers.append(["Cookie", "; ".join(f"{c['name']}={c['value']}" for c in session["cookies"])])
if headers:
body["headers"] = headers
p = requests.post(f"{API}/api/single/", headers=H, json=body).json()
print(sku, p["status"])
Đọc session bằng .get(). Một session được tạo thành công bởi một lệnh fetch qua proxy thông thường sẽ có proxy và không có userAgent, và một số kết quả trả về hoàn toàn không có session.
Lệnh gọi Auto tiêu tốn lượng tín dụng dựa trên mức chi tiêu của ladder tương ứng. Mỗi lệnh gọi Single tiếp theo tốn 2 credit (Single với unblocker, là giá trị mặc định).
Pattern 2: Proxy phát hiện, Browser render qua cùng một exit
Sử dụng phương pháp này khi mục tiêu yêu cầu một quốc gia exit cụ thể và nội dung cuối cùng cần thực thi JavaScript.
# Step 1: pick a country-scoped exit with Proxy.
curl -X POST https://eu.api.foura.ai/api/proxy/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"maxTries": 5,
"exitCountries": ["FR", "GB"],
"request": {"method": "GET", "url": "https://example.com/pricing"}
}'
# Response includes: "proxy": "A1B2C3", "exitCountry": "FR"
# Step 2: render the JS-heavy page through THAT exit.
curl -X POST https://eu.api.foura.ai/api/browser/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/pricing",
"proxy": "A1B2C3",
"timeout_ms": 20000
}'
Không gọi lại /api/proxy/ để làm mới lựa chọn. Một lệnh gọi mới có thể chọn một exit khác và làm mất tác dụng của việc ghim. Nếu exit đã ghim ngừng hoạt động, hãy thực hiện một lệnh gọi /api/proxy/ mới để chọn một exit khác, sau đó tiếp tục với exit đó.
Pattern 3: Bỏ qua một exit bị chặn
Nếu một exit từng hoạt động bắt đầu trả về lỗi từ chối hoặc các trang xác minh, hãy yêu cầu FourA tránh exit đó trong lần lựa chọn tiếp theo.
{
"maxTries": 5,
"ignoreProxies": ["A1B2C3"],
"request": { "method": "GET", "url": "https://example.com/data" }
}
ignoreProxies chấp nhận một danh sách proxy ID từ các response trước đó. Thuộc tính này hoạt động trên /api/proxy/ và /api/auto/. Danh sách này được tuân thủ trong mỗi lần retry nội bộ, do đó một lệnh gọi duy nhất với ignoreProxies sẽ không bao giờ chọn lại các exit node đã bị chặn.
Thời Gian Một Pinned Session Duy Trì Hoạt Động
Bản thân exit node tồn tại chừng nào proxy bên dưới còn hoạt động tốt, thường từ vài phút đến vài giờ. Nếu một replay bắt đầu trả về challenge, block, hoặc redirect không mong muốn, có thể exit node đã bị xoay vòng hoặc trang đích đã làm mới cơ chế xác thực clearance.
Hai tùy chọn khi điều đó xảy ra:
- Thực hiện lệnh gọi
/api/auto/mới cho cùng URL đó. Auto sẽ khám phá một session hoạt động mới; hãy bỏ qua các ID trước đó. - Thực hiện lệnh gọi
/api/proxy/mới vớiignoreProxies: ["<burned-id>"]nếu bạn muốn tiếp tục ghim thủ công.
Session cookie từ response của Auto cũng hết hạn theo lịch trình riêng của trang đích. Một số trang duy trì clearance trong vài giờ; một số khác chỉ trong vài phút. Hãy xem session này như một bộ nhớ cache, không phải là token vĩnh viễn.
Khi Một ID Không Thể Ghim
Có ba lỗi 400 có thể trả về từ một giá trị proxy, và chúng mang ý nghĩa khác nhau:
| Lỗi | Nguyên nhân | Hướng xử lý |
|---|---|---|
Invalid proxy format |
Giá trị không phải là ID do FourA phát hành. Địa chỉ proxy thô sẽ rơi vào trường hợp này. | Gửi chính xác chuỗi opaque nhận được từ response. |
Proxy not found |
ID đã giải mã, nhưng không còn trỏ tới một exit node đang hoạt động. | Lấy một exit node mới từ lệnh gọi Auto hoặc Proxy mới. |
Managed exit: this proxy id cannot be pinned to a request |
ID là một exit node premium, và lưu lượng premium trong gói của bạn cho chu kỳ này đã hết, hoặc gói của bạn không bao gồm exit node premium. | Chạy lệnh gọi qua POST /api/proxy/ và nhận exit node được chọn, hoặc bổ sung lưu lượng premium rồi ghim lại. |
Trường hợp thứ ba có thể xuất hiện từ một ID do lệnh gọi thành công trả về, nghĩa là bạn có thể gặp lỗi này ngay cả khi không thao tác sai. Hãy xử lý tương tự như một session đã hết hạn: chuyển hướng dự phòng sang lệnh gọi tìm kiếm mới thay vì thử lại cùng một ID.
Các Lỗi Thường Gặp
- Dùng lại proxy ID giữa các tài khoản. Không chia sẻ ID giữa các tài khoản: một ID mà tài khoản này có thể ghim có thể bị từ chối ở tài khoản khác, ví dụ như một exit cao cấp trên gói cước không có lưu lượng premium.
- Cố gắng giải mã ID. Chuỗi base36 này là opaque. Không phân tích cú pháp, không cắt bớt ký tự, không chuyển thành chữ thường. Hãy truyền lại nguyên văn.
- Ghim qua một exit đang bị rate limit. Nếu mục tiêu giới hạn rate limit theo IP, việc dồn nhiều request qua một exit sẽ khiến bạn bị chặn nhanh hơn. Đối với khối lượng công việc lớn, hãy để Auto hoặc Proxy xoay vòng qua nhiều exit và chỉ ghim khi mục tiêu thực sự yêu cầu điều đó.
- Vô tình ghim một exit cao cấp. ID từ một lệnh gọi do exit cao cấp phục vụ (
exitClass: "premium"trên Proxy hoặc Auto) sẽ ghim một exit cao cấp. ID từ lệnh gọi Auto cao cấp sẽ ghim một exit cao cấp trên Single hoặc Browser, nhưng không nhất thiết phải là địa chỉ mà Auto đã sử dụng. Mỗi lần phát lại qua đó đều được tính vào lưu lượng premium của bạn, và response sẽ đi kèmX-FourA-Exit-Class: premium. - Gửi
exitCountriestrên gói cước không hỗ trợ geo targeting. Tính năng định vị quốc gia được bao gồm từ gói Startup trở lên. Trên gói cước không hỗ trợ, lệnh gọi gửiexitCountriessẽ bị từ chối với403vàX-FourA-Limit: plan_limit_feature. - Bỏ qua
exitCountriestrong lệnh gọi tiếp theo. Nếu bạn ghim một exit có phạm vi vị trí rồi gọi lại Proxy mà không cóexitCountries, lệnh gọi tiếp theo có thể đi qua một quốc gia khác. Hãy duy trì tham số scope trên mọi lệnh gọi cần đến nó.
Liên quan
- API Endpoints: Tài liệu tham khảo đầy đủ về tham số và response
- Smart Fetch (Auto): Cách Auto xây dựng phiên bạn phát lại
- Protected sites: Khi nào nên ghim và khi nào xoay vòng sẽ tốt hơn
- Common Issues:
no_eligible_proxyvà các lỗi proxy khác - Why a Proxy Request Ran Out of Tries: Đọc
attemptReportkhi một lệnh gọi Proxy dừng lại