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

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

Ръководство за бързо решение

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

  • Таргетирате нов сайт и все още не знаете от какво се нуждае
  • Искате една заявка, която автоматично управлява ротацията на proxy и резервните варианти с browser
  • Искате сесия, която можете да преизползвате изгодно при следващото извикване към същия хост

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

  • Страницата е с рендиране от страна на сървъра (не изисква JavaScript)
  • Имате нужда от максимална скорост (обикновено под 1 секунда)
  • Достъпвате API-та или статични HTML страници от хост, за който вече знаете, че работи

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

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

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

  • Таргет сайтът активно блокира заявки
  • Трябва да ротирате между множество IP адреси
  • Предишните опити са върнали 403 или страници за верификация

Сравнение на endpoint-ите

Auto (POST /api/auto/)

Endpoint за интелигентно извличане. Подавате URL и (в идеалния случай) validate правило, а FourA преминава през оптимизирана по разходи стълбица: първо ротирано proxy, след това пълен browser през proxy. Задайте forceProxy: false и евтина директна проверка заедно с директно browser рендиране ще се изпълнят преди тях. Първото ниво, което върне 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"]}}
  }'

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

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

Single (POST /api/single/)

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

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"
  }'

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

Proxy (POST /api/proxy/)

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

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"
    }
  }'

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

Auto срещу Manual

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

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

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

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

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

  1. Откриване с auto: подайте правило validate и оставете стълбицата да определи кое ниво е необходимо за сайта.
  2. Повторение със single: вземете върнатите от auto session.proxy, session.cookies и session.userAgent, след което извикайте Single с тях за следващите страници на същия host.
  3. Превключване към browser: ако single започне да връща грешки, преминете към browser рендиране.
  4. Добавяне на proxy: ако получавате отказ (403 или страница за верификация) без auto, обвийте вашата заявка в proxy endpoint за автоматична ротация.

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

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

  • Подавайте validate.data.accept подниз при защитени цели. Auto разпознава стандартните страници с предизвикателства самостоятелно, но само вашето правило може да улови непозната страница за проверка или страница, заредена без нужното съдържание.
  • Използвайте single endpoint по подразбиране за доказано работещи hosts и преминавайте към по-високо ниво само при нужда.
  • Задавайте checkText в browser заявки, така че страница, рендирана без вашето съдържание, да се връща като неуспех (checkText:<text> not found) вместо като успех. checkText не кара FourA да чака по-дълго за текста.
  • Задавайте maxTries в proxy заявки, за да контролирате поведението при повторни опити (по подразбиране е 5, максимумът е 90).
  • Поддържайте timeout_ms в разумни граници: 10 до 15 секунди за повечето страници, 30s+ за първоначални auto изпълнения срещу защитени сайтове.

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

Обновено: 5 ноември 2026 г.