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

> URL: https://foura.ai/bg/docs/guides/choosing-task-type
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

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`, печели. При повторни извиквания към същия хост се преизползва топла сесия, така че второто извикване е евтино.

```bash
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](https://foura.ai/docs/guides/smart-fetch).

### Single (`POST /api/single/`)

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

```bash
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.

```bash
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 опитва отново през различни проксита.

```bash
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 изпълнения срещу защитени сайтове.

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

- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Подробен преглед на `/api/auto/`
- [API Endpoints](https://foura.ai/docs/api/endpoints): Пълна документация за параметрите
- [Scrape a Dynamic Website](https://foura.ai/docs/how-to/scrape-dynamic-website): Ръководство стъпка по стъпка за browser заявки
- [Quick Start](https://foura.ai/docs/getting-started/quick-start): Вашата първа заявка за 30 секунди
