Повторное использование proxy между requests
Узнайте, как сохранять один и тот же выходной proxy для последующих запросов, чтобы рендеринг JavaScript, вызовы API и постраничные выборки выполнялись с одного IP.
Зачем повторно использовать proxy
При первом обращении к цели FourA выбирает для вас рабочий proxy. Ответ Proxy или Auto содержит ID использованного proxy. Передайте этот ID в последующих запросах, и:
- Последующие страницы будут запрашиваться через тот же выходной узел, сохраняя session cookie и лимиты rate limit согласованными для целевого сервиса.
- Запрос с фильтром по стране останется в рамках вашего списка разрешенных без повторного выбора.
- Недорогой endpoint
POST /api/single/повторно использует proxy, за обнаружение которого вы уже заплатили, по стоимости Single вместо Proxy.
ID proxy представляет собой непрозрачную строку 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, содержит proxy и не содержит userAgent, а некоторые ответы вообще не содержат session.
Вызов Auto стоит столько, сколько расходует его цепочка. Каждый последующий вызов 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/ повторно для обновления выборки. Новый вызов может выбрать другой выходной узел и свести на нет смысл фиксации. Если зафиксированный выходной узел перестает работать, выполните новый вызов /api/proxy/, чтобы выбрать новый, а затем продолжите работу с ним.
Шаблон 3: Пропуск скомпрометированного выходного узла
Если ранее работавший выходной узел начинает возвращать отказы или страницы проверки, укажите FourA избегать его при следующем выборе.
{
"maxTries": 5,
"ignoreProxies": ["A1B2C3"],
"request": { "method": "GET", "url": "https://example.com/data" }
}
ignoreProxies принимает список proxy ID из предыдущих ответов. Параметр поддерживается в /api/proxy/ и /api/auto/. Список учитывается при каждом внутреннем retry, поэтому один запрос с ignoreProxies гарантированно не выберет скомпрометированные exit node.
Сколько живет закрепленная сессия
Сам exit node остается активным до тех пор, пока жив соответствующий proxy, обычно от нескольких минут до нескольких часов. Если повторный запрос начинает возвращать challenge, блокировки или неожиданные redirect, exit node, скорее всего, сменился, либо целевой ресурс обновил параметры clearance.
В таких случаях есть два варианта действий:
- Выполнить новый запрос
/api/auto/к тому же URL. Режим Auto найдет новую рабочую сессию; старые ID следует отбросить. - Выполнить новый запрос
/api/proxy/с параметромignoreProxies: ["<burned-id>"], если требуется продолжать ручное закрепление.
Срок действия session cookie из ответа Auto также определяется целевым сайтом. Некоторые ресурсы сохраняют clearance часами, другие сбрасывают его через несколько минут. Относитесь к сессии как к кэшу, а не как к постоянному токену.
Когда ID не закрепляется
Значение proxy может вернуть три разных ошибки 400 со специфическим смыслом:
| Ошибка | Причина | Что делать |
|---|---|---|
Invalid proxy format |
Значение не является ID, выпущенным FourA. Прямой адрес proxy приведет к этой ошибке. | Передавайте opaque-строку из ответа без изменений. |
Proxy not found |
ID декодирован, но больше не указывает на активный exit node. | Получите свежий exit node через новый запрос Auto или Proxy. |
Managed exit: this proxy id cannot be pinned to a request |
ID относится к premium exit node, но лимит premium-трафика для текущего периода исчерпан, либо тариф не поддерживает premium exit node. | Выполните запрос через POST /api/proxy/ и используйте выбранный exit node, либо добавьте premium-трафик и закрепите его снова. |
Третья ошибка может вернуться для ID, полученного из успешного запроса, поэтому столкнуться с ней можно даже без ошибок в логике. Обрабатывайте ее так же, как истекшую сессию: переключайтесь на новый discovery-запрос вместо повторных попыток с тем же ID.
Частые ошибки
- Повторное использование ID proxy между аккаунтами. Не используйте ID совместно между разными аккаунтами: ID, закрепленный за одним аккаунтом, может быть отклонен другим, например, премиум-выход на тарифе без премиум-трафика.
- Попытки декодировать ID. Строка base36 непрозрачна. Не парсите ее, не удаляйте символы и не переводите в нижний регистр. Передавайте ее в исходном виде.
- Закрепление выхода, ограниченного rate limit. Если целевой ресурс ограничивает rate limit на IP, отправка множества запросов через один выход быстрее приведет к блокировкам. Для высоконагруженных задач позвольте Auto или Proxy ротировать выходы и закрепляйте их только тогда, когда этого действительно требует целевой ресурс.
- Случайное закрепление премиум-выхода. ID из вызова, обработанного премиум-выходом (
exitClass: "premium"в Proxy или Auto), закрепляет премиум-выход. ID из премиум-вызова Auto закрепляет премиум-выход в Single или Browser, но не обязательно тот же адрес, который использовал Auto. Каждый повторный запрос через него расходует ваш премиум-трафик, а ответ содержитX-FourA-Exit-Class: premium. - Отправка
exitCountriesна тарифе без геотаргетинга. Таргетинг по странам доступен начиная с тарифа Startup. На тарифе без этой опции вызов сexitCountriesотклоняется с403иX-FourA-Limit: plan_limit_feature. - Игнорирование
exitCountriesв последующем вызове. Если вы закрепили выход с геопривязкой, а затем снова вызвали Proxy безexitCountries, следующий запрос может пройти через другую страну. Указывайте геопривязку в каждом вызове, где она необходима.
Связанные разделы
- API Endpoints: Полный справочник по параметрам и ответам
- Smart Fetch (Auto): Как Auto создает сессию, которую вы воспроизводите
- Защищенные сайты: Когда помогает закрепление, а когда лучше использовать ротацию
- Частые проблемы:
no_eligible_proxyи другие ошибки proxy - Почему в Proxy Request исчерпаны попытки: Разбор
attemptReport, когда вызов Proxy завершается неудачей