Proxy порт

Изпращайте собствения си трафик през изходните точки на FourA от всеки клиент, който приема proxy URL: браузър, инструмент за изтегляне, scraper, който вече използвате. Proxy портът отваря тунел към посочената от вас цел и прехвърля байтове в двете посоки, като по този начин поддържа това, което JSON API не може: потоци от данни, големи изтегляния и цели браузърни сесии.

Бета. Proxy портът е в бета версия. Трафикът през него все още не се таксува, не е покрит от мониторинг или ангажимент за ъптайм, а имената на опциите все още могат да се променят. Споделете с нас, ако нещо спре да работи.

Свързване

Данните за вход се генерират от таблото за управление. Създайте proxy потребител в раздел Proxy в страничната лента, за да получите генерирано потребителско име и парола. Те умишлено са отделени от вашия API ключ: proxy ръкостискането преминава в открит текст при всяка връзка, а proxy потребител може да бъде подменян, без това да засяга вашата API интеграция. Вижте Proxy Users.

curl -x http://USERNAME:PASSWORD@proxy.foura.ai:34004 https://example.com

import requests

proxy = "http://USERNAME:PASSWORD@proxy.foura.ai:34004"
r = requests.get("https://example.com", proxies={"https": proxy, "http": proxy})
print(r.status_code)

Портът поддържа само CONNECT. https:// цел се тунелира от всеки клиент. Обикновена http:// цел работи, когато вашият клиент също я тунелира (curl: --proxytunnel); клиент, който вместо това препраща обикновената заявка към проксито, получава 405 Method Not Allowed.

Опциите се предават в потребителското име

Всичко след идентификационните данни е списък от -key-value двойки, в произволен ред:

USERNAME-network-residential-country-de-session-a1

Стойностите са думи с малки букви. Тире вътре в стойност започва нова опция, така че -city-new-york се чете като две опции и се отхвърля. Непознат ключ също се отхвърля, никога не се пренебрегва: грешно изписан -contry-de връща 400 с имената на поддържаните ключове, вместо да се изпълни от грешна държава.

Всяка опция с изключение на network, fallback и session приема any, което изчиства запазената за proxy потребителя стойност само за тази връзка.

Три комбинации се отхвърлят с 400 вместо частично изпълнение:

• state, city, asn, os или lifetime в споделената мрежа. Споделената мрежа се избира само по държава и нищо по-детайлно; добавете -network-residential за таргетиране по град.
• -fallback-residential заедно с -network-residential. Fallback няма приложение в мрежата, към която превключва.
• По-детайлно таргетиране с активиран fallback. Fallback може да се задейства или не, затова град, който би могъл да се уважи само понякога, се отхвърля.

Сесии

В споделената мрежа именувана сесия запазва същия изход, докато продължавате да я използвате, в плъзгащ се десетминутен прозорец. Ако този изход спре да работи, сесията се прехвърля към друг, вместо да прекъсне. Браузър, управляван през порта, винаги трябва да съдържа име на сесия: зареждането на страница отваря десетки връзки и без сесия всяка от тях излиза от различен адрес.

В residential мрежата именувана сесия задържа адреса си за lifetime минути или за стандартното за мрежата време, ако не е зададено друго.

Запазени стойности по подразбиране

Таргетирането, запазено за даден proxy потребител в таблото за управление, се прилага за всяка връзка, направена чрез него, така че потребителското име може да остане кратко. Всичко, което въведете в потребителското име, има предимство за конкретната връзка, а any отменя запазена стойност. Запазената стойност по подразбиране за residential таксува само когато вашият план го позволява; в противен случай връзката се обслужва от споделената мрежа.

CONNECT headers

Клиент, който може да добавя headers към CONNECT request, може да изпраща същите опции като headers. Даден header има предимство пред същата опция в потребителското име.

curl -x http://USERNAME:PASSWORD@proxy.foura.ai:34004 \
  --proxy-header "X-Foura-Country: de" \
  https://example.com

Responses

Тунел, който се отваря успешно, връща 200 Connection established. Всеки отказ съдържа заглавка X-Foura-Error с причина от един ред, затова проверете тази заглавка преди всичко останало.

Лимити

• До 200 едновременно отворени тунела за всеки proxy потребител.
• Намирането на изходен възел отнема до 45 секунди, преди портът да прекрати опита с грешка 502. Сесия, която вече има изходен възел, обикновено се свързва за доста под секунда.
• Тунел без трансфер на байтове в двете посоки се затваря след две минути бездействие.
• Прокси потребител, който деактивирате или изтриете в таблото за управление, спира да се удостоверява в рамките на една минута.

Отчитане

Байтовете през порта се отчитат към трафика на вашата страница Usage & Limits, а байтовете през жилищен изходен възел се отчитат и към вашия премиум трафик. Връзка, която изрично посочва -network-residential след изчерпване на премиум лимита, все пак се обслужва; резервен вариант или запазена по подразбиране жилищна конфигурация не се прилагат в това състояние, а споделената мрежа обслужва връзката вместо това.

Свързани

• Proxy Users: Създаване на прокси потребители и генериране на connection string в таблото
• Proxy Request: Алтернативата чрез JSON API с вградени повторни опити и валидация
• Reuse a Proxy Across Requests: Запазване на един и същ изходен възел в JSON API
• Usage & Limits: Трафик и премиум потребление спрямо вашия план