Преизползване на прокси между заявки
Научете как да запазите същия изходен proxy за последващи заявки, така че JavaScript рендирането, API извикванията и страницираните извличания да излизат от един и същ IP адрес.
Защо да използвате повторно proxy
Когато правите първа заявка към целта, FourA избира работещ proxy за вас. Отговор от Proxy или Auto съдържа използваното proxy ID. Подайте това ID обратно при следващите заявки и:
- Последващите страници преминават през същия изход, така че бисквитките за сесия и лимитите за скорост остават съгласувани спрямо целта.
- Извличане с обхват на държава остава в рамките на вашия allowlist без нов избор.
- Евтиният endpoint
POST /api/single/повтаря заявката през proxy, за чието откриване вече сте платили, на цената на Single вместо на Proxy.
Това proxy ID е непрозрачен base36 низ (нещо като A1B2C3). Никога реален IP адрес.
Къде се намира ID в отговора
| Endpoint | Поле | Кога е налично |
|---|---|---|
POST /api/auto/ |
session.proxy |
Когато returnSession е true (по подразбиране) |
POST /api/single/ |
proxy (най-високо ниво) |
Само когато заявката е предоставила поле proxy |
POST /api/proxy/ |
proxy (най-високо ниво) |
Винаги, при успех |
POST /api/browser/ |
proxy (най-високо ниво) |
Само когато заявката е предоставила поле proxy |
За да вземете нов изход без предварително фиксиране, започнете с Auto или Proxy. И двата откриват работещ изход и връщат неговото ID.
Модел 1: Auto открива, Single повтаря
Най-подходящ, когато имате цел, която все още не познавате. Auto преминава стъпките веднъж, след което Single използва повторно успешната сесия за всяка следваща страница.
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"])
Прочетете сесията с .get(). Сесия, спечелена чрез стандартен proxy fetch, има proxy и няма userAgent, а някои отговори не носят никакви session.
Извикването на Auto струва толкова, колкото изразходва неговата ladder структура. Всяко последващо извикване на Single струва 2 кредита (Single с unblocker, по подразбиране).
Модел 2: Proxy открива, Browser рендерира през същия изходен адрес
Използвайте това, когато целта трябва да вижда конкретна държава на изхода, а крайното съдържание изисква 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
}'
Не извиквайте /api/proxy/ отново, за да опресните избора. Ново извикване може да избере различен exit и да обезсмисли фиксирането (pinning). Ако фиксираният exit спре да работи, изпълнете ново извикване на /api/proxy/, за да изберете нов, и след това продължете с него.
Pattern 3: Пропускане на компрометиран exit
Ако exit, който преди е работил, започне да връща откази или страници за верификация, задайте на FourA да го избягва при следващия избор.
{
"maxTries": 5,
"ignoreProxies": ["A1B2C3"],
"request": { "method": "GET", "url": "https://example.com/data" }
}
ignoreProxies приема списък от proxy ID от предишни отговори. Работи при /api/proxy/ и /api/auto/. Списъкът се зачита при всяко вътрешно повторение, така че единично извикване с ignoreProxies никога не избира компрометираните изходи.
Колко време остава активна закачената сесия
Самият изход остава активен, докато базовото proxy е изправно, обикновено от минути до часове. Ако повторното изпълнение започне да връща проверки, блокирания или неочаквани пренасочвания, изходът вероятно е бил ротиран или целта е обновила разрешението за достъп.
Две опции, когато това се случи:
- Ново извикване на
/api/auto/за същия URL. Auto ще открие нова работеща сесия; премахнете предишните ID. - Ново извикване на
/api/proxy/сignoreProxies: ["<burned-id>"], ако искате да продължите ръчното закачане.
Бисквитките за сесия от Auto отговор също изтичат според графика на самата целева страница. Някои сайтове запазват разрешението с часове; други за минути. Третирайте сесията като кеш, а не като постоянен token.
Когато дадено ID не се закача
Три грешки 400 могат да бъдат върнати от стойност на proxy и те означават различни неща:
| Грешка | Какво се случи | Какво да направите |
|---|---|---|
Invalid proxy format |
Стойността не е ID, издадено от FourA. Необработен proxy адрес попада тук. | Изпратете непроменения opaque низ от отговора, дословно. |
Proxy not found |
ID е декодирано, но вече не сочи към активен изход. | Вземете нов изход от ново Auto или Proxy извикване. |
Managed exit: this proxy id cannot be pinned to a request |
Това ID е премиум изход, а премиум трафикът от вашия план за този период е изчерпан или планът ви не включва премиум изходи. | Изпълнете извикването през POST /api/proxy/ и вземете изхода, който то избере, или добавете премиум трафик и го закачете отново. |
Третата грешка идва от ID, което успешно извикване ви е върнало, така че може да я срещнете без да сте сгрешили нищо. Третирайте я по същия начин, както бихте третирали изтекла сесия: преминете към ново извикване за откриване вместо повторно извикване със същото ID.
Чести грешки
- Повторно използване на proxy ID между акаунти. Не споделяйте ID между акаунти: ID, което един акаунт може да фиксира, може да бъде отхвърлено за друг, например premium exit при план без premium трафик.
- Опит за декодиране на ID. Низът base36 е непрозрачен. Не го парсвайте, не премахвайте символи и не го преобразувайте в малки букви. Изпращайте го обратно дословно.
- Фиксиране през rate-limited exit. Ако таргетът налага rate limit по IP, насочването на много заявки през един exit ще доведе до по-бързи блокирания. За натоварвания с голям обем оставете Auto или Proxy да редуват множество exits и фиксирайте само там, където таргетът наистина го изисква.
- Случайно фиксиране на premium exit. ID от извикване, обслужено от premium exit (
exitClass: "premium"при Proxy или Auto), фиксира premium exit. ID от premium Auto извикване фиксира premium exit при Single или Browser, но не непременно адреса, който Auto е използвал. Всяко повторно изпълнение през него се отчита към вашия premium трафик, а отговорът съдържаX-FourA-Exit-Class: premium. - Изпращане на
exitCountriesпри план без geo targeting. Country scoping е включен от план Startup нагоре. При план без тази функция, извикване сexitCountriesсе отхвърля с403иX-FourA-Limit: plan_limit_feature. - Игнориране на
exitCountriesпри последващо извикване. Ако фиксирате scoped exit и след това извикате Proxy отново безexitCountries, последващата заявка може да премине през различна държава. Запазвайте обхвата при всяко извикване, което се нуждае от него.
Свързани
- API Endpoints: Пълна справка за параметри и отговори
- Smart Fetch (Auto): Как Auto изгражда сесията за повторно изпълнение
- Protected sites: Кога фиксирането помага и кога ротацията е по-добро решение
- Common Issues:
no_eligible_proxyи други proxy грешки - Why a Proxy Request Ran Out of Tries: Разчитане на
attemptReport, когато Proxy извикване се откаже