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

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

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

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

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

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

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

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

• Страницата разчита на JavaScript, за да визуализира съдържание
• Съдържанието се зарежда след първоначалното зареждане на страницата
• Нуждаете се от напълно render-нат DOM

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

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

Сравнение на endpoints

Auto (POST /api/auto/)

Смарт-fetch endpoint. Подавате URL и (в идеалния случай) validate правило, а FourA преминава през оптимизирана по разходи стълбица: първо ротирано proxy, след това пълен browser през proxy. Задайте forceProxy: false и преди двете ще се изпълнят евтина direct проверка и директен browser render. Първото ниво, което върне 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-подобни характеристики на мрежово ниво, без да стартира browser процес.

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 Най-подходящо за: API, новинарски сайтове, блогове, статични продуктови страници

Browser (POST /api/browser/)

Отваря вашия URL в Chrome browser инстанция. Страницата се зарежда напълно, 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"
    }
  }'

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

Auto срещу Manual

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

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

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

Някои работни процеси се възползват от използването на няколко endpoint-а:

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

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

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

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

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

• Smart Fetch (Auto): Подробно ръководство за /api/auto/
• API Endpoints: Пълна документация за параметрите
• Scrape a Dynamic Website: Ръководство стъпка по стъпка за browser заявки
• Quick Start: Вашата първа заявка за 30 секунди