Избор на правилния endpoint

FourA предлага четири request endpoints, всеки оптимизиран за различен сценарий. Изборът на правилния пести време, намалява разходите и подобрява успеваемостта.

Кратко ръководство за избор

Използвайте auto endpoint, когато:

Насочвате се към нов сайт и все още не знаете какво изисква той
Искате едно извикване, което обработва директни, proxy-rotated и browser fallbacks вместо вас
Искате сесия, която можете да преиграете евтино при следващото извикване към същия хост

Използвайте single endpoint, когато:

Страницата е server-rendered (не се изисква JavaScript)
Имате нужда от максимална скорост (обикновено под 1 секунда)
Заявявате APIs или статични HTML страници от хост, за който вече знаете, че работи

Използвайте browser endpoint, когато:

Страницата разчита на JavaScript за рендиране на съдържание
Съдържанието се зарежда след първоначалното зареждане на страницата
Имате нужда от напълно рендиран DOM

Използвайте proxy endpoint, когато:

Целевият сайт активно блокира заявки
Имате нужда от ротация през множество IP адреси
Предишни опити са върнали 403 или captcha страници

Сравнение на Endpoints

Auto (`POST /api/auto/`)

Smart-fetch endpoint-ът. Подавате URL и (в идеалния случай) validate правило, а FourA преминава през съобразена с разходите стълбица: евтин директен сондаж, ротирано proxy, пълен браузър. Печели първото стъпало, което върне response, съвпадащ с вашето validate. При повторни извиквания към същия хост се преиграва топла сесия, така че второто извикване е евтино.

curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'

Типично време за response: 200ms (warm) до 30s+ (cold solve на труден сайт) Най-добро за: Нови цели, сайтове със смесена защита, "просто искам страницата"

За по-подробен преглед вижте ръководството Smart Fetch.

Single (`POST /api/single/`)

Най-бързата опция. Изпраща HTTP request с реалистични browser-like мрежови характеристики, без да стартира браузърен процес.

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com/api/products"}'

Типично време за response: 200ms до 2s Най-добро за: APIs, новинарски сайтове, блогове, статични продуктови страници

Browser (`POST /api/browser/`)

Отваря вашия URL в инстанция на браузъра Chrome. Страницата се зарежда напълно, JavaScript се изпълнява и получавате крайния рендиран HTML.

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/spa-app",
    "timeout_ms": 15000,
    "checkText": "data-table"
  }'

Типично време за response: 2s до 10s Най-добро за: Single-page apps (SPAs), сайтове с мързеливо зареждане (lazy loading), JavaScript-rendered съдържание

Proxy (`POST /api/proxy/`)

Комбинира HTTP requests с автоматична proxy ротация. Ако първият опит се провали или бъде блокиран, FourA опитва отново през различни proxies.

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,
    "request": {
      "method": "GET",
      "url": "https://example.com/pricing"
    }
  }'

Типично време за response: 1s до 5s Най-добро за: Мониторинг на цени в електронната търговия, агрегиране на пътувания, сайтове с детекция на ботове

Auto срещу Manual

Кога трябва да оставите auto да избере и кога трябва да извикате Single, Proxy или Browser сами?

Изберете auto	Изберете manual
Все още не знаете какво изисква сайтът	Знаете точно кой engine изисква целта
Искате едно извикване, което просто работи	Оптимизирате формата на заявката за позната цел
Устройва ви auto да използва повторно сесия, която е научило	Искате пълен контрол върху повторните опити, timeout и избора на proxy за всяко извикване
Плащате за няколко секунди сондиране при първото извикване	Латентността при първото извикване е по-важна от откриването

Auto не винаги е по-евтиният избор. Ако вече знаете, че дадена цел работи със Single и включено unblocker, директното извикване на Single пропуска сондажа и струва 2 кредита. Auto към същата цел струва толкова, колкото изразходва неговата стълбица.

Кога да комбинирате подходи

Някои работни процеси се възползват от използването на множество endpoints:

Откриване с auto: подайте validate правило и оставете стълбицата да разбере кое стъпало е необходимо на сайта.
Преиграване със single: вземете session.proxy, session.cookies и session.userAgent, които auto е върнал, след което извикайте Single с тях за последващи страници на същия хост.
Връщане към browser (fallback): ако single започне да дава грешки, превключете към browser рендиране.
Добавяне на proxy: ако бъдете блокирани (403 / captcha) без auto, обвийте своя request в proxy endpoint за автоматична ротация.

Този прогресивен подход поддържа разходите ниски, като същевременно запазва висока успеваемост.

Съвети за производителност

Подавайте validate.data.accept подниз за защитени цели. Без него auto не може да различи реална страница от междинна страница с предизвикателство.
Използвайте single endpoint по подразбиране за хостове, за които се знае, че работят, и надграждайте само когато е необходимо.
Задайте checkText в browser requests, за да избегнете чакане за ненужно съдържание.
Задайте maxTries в proxy requests, за да контролирате поведението при повторни опити (по подразбиране е 5, максимумът е 90).
Поддържайте timeout_ms в разумни граници: 10 до 15 секунди за повечето страници, 30s+ за cold auto изпълнения срещу защитени сайтове.

Следващи стъпки

Smart Fetch (Auto): Подробен преглед на /api/auto/
API Endpoints: Пълна справка за параметрите
Извличане на данни от динамичен уебсайт: Ръководство стъпка по стъпка за browser request
Бърз старт: Вашият първи request за 30 секунди

Обновено: 30 юни 2026 г.