Proxy порт

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

Свързване

Данните за достъп се взимат от таблото за управление. Създайте proxy потребител под Proxy в страничната лента и ще получите генерирани потребителско име и парола. Те умишлено са отделени от вашия API key: proxy handshake се предава в открит вид при всяко свързване, а 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); клиент, който вместо това препраща обикновената заявка към proxy, получава 405 Method Not Allowed.

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

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

USERNAME-network-premium-country-de-session-a1

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

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

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

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

Сесии

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

В premium мрежата именувана сесия задържа адреса си за lifetime минути или според стойността по подразбиране за мрежата, ако не зададете такава.

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

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

CONNECT заглавки

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

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

Отговори

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

Лимити

• Едновременно отворените тунели и отварянията на тунели в минута се определят от вашия план и се отчитат за целия акаунт, а не за отделен proxy потребител: създаването на втори набор от данни не осигурява допълнителен лимит. Вашите стойности се намират в Usage & Limits.
• Търсенето на изход отнема до 45 секунди, преди портът да прекрати опита с грешка 502. Сесия с вече установен изход обикновено се свързва за значително под една секунда.
• Тунел без трансфер на байтове в двете посоки се затваря след две минути бездействие.
• При обновяване на порта вече отворените тунели разполагат с малко под три минути за завършване и след това се затварят, докато новите връзки продължават да се отварят. При продължително теглене или поток трябва да се осъществи повторно свързване след затваряне на тунела.
• Proxy потребител, деактивиран или изтрит в контролния панел, спира да се автентикира в рамките на една минута.

Измерване на трафика

Байтовете през порта се отчитат към трафика на вашата страница Usage & Limits, а байтовете през premium изход се отчитат и към вашия premium трафик: едни и същи байтове, отчетени два пъти, без сумиране. При отваряне на тунел трафикът от опитите за връзка през premium изходи, които портът е опитал, но не е използвал, също се отчита като premium трафик. Неизползваните опити в споделената мрежа не се начисляват, а при неуспешно отваряне на тунел не се отчита нищо.

Стандартният трафик, който портът може да използва, е според вашия план. При план, продаван с кредити, портът разполага със собствени включени гигабайти, а страницата Billing предлага закупуване на допълнителни; при план, продаван на база трафик, той черпи от същия общ пул като API. Когато той се изчерпи, новите връзки се отхвърлят, докато периодът не се поднови или не добавите още трафик, а имейлите за потребление посочват кога.

След като лимитът за премиум трафик бъде изчерпан, трите начина за достъп до тази мрежа се обработват различно, нарочно. Връзка, която изрично посочва -network-premium, се отхвърля с грешка 403, указваща причината, тъй като клиент, поискал платено използване и обслужен тихо от друго място, би продължил да изпраща заявки и да очаква премиум линия, която така и не се появява. Резервен вариант не се използва, а премиум настройка по подразбиране, запазена за proxy потребителя, се понижава до споделената мрежа, която все пак отваря тунела: нито един от тези случаи не е избрал изрично платено потребление за тази връзка.

Свързани

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