# Wybór odpowiedniego endpointu

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

FourA oferuje cztery endpointy do zapytań, z których każdy jest zoptymalizowany pod kątem innego scenariusza. Wybór odpowiedniego oszczędza czas, obniża koszty i zwiększa wskaźnik sukcesu.

## Szybki przewodnik

**Użyj endpointu auto, gdy:**
- Kierujesz zapytania do nowej witryny i jeszcze nie wiesz, czego ona wymaga
- Chcesz jednego wywołania, które automatycznie obsłuży rotację proxy i przejścia awaryjne do przeglądarki
- Potrzebujesz sesji, którą można tanio odtworzyć przy kolejnym wywołaniu do tego samego hosta

**Użyj endpointu single, gdy:**
- Strona jest renderowana po stronie serwera (nie wymaga JavaScriptu)
- Wymagasz maksymalnej prędkości (zwykle poniżej 1 sekundy)
- Odpytujesz API lub statyczne strony HTML z hosta, o którym wiesz, że działa

**Użyj endpointu browser, gdy:**
- Strona opiera się na JavaScripcie do renderowania treści
- Treść ładuje się po początkowym załadowaniu strony
- Potrzebujesz w pełni wyrenderowanego drzewa DOM

**Użyj endpointu proxy, gdy:**
- Docelowa witryna aktywnie blokuje zapytania
- Musisz rotować zapytania przez wiele adresów IP
- Poprzednie próby zwróciły kod 403 lub strony weryfikacyjne

## Porównanie endpointów

### Auto (`POST /api/auto/`)

Endpoint typu smart-fetch. Przekazujesz URL oraz (najlepiej) regułę `validate`, a FourA przechodzi przez kolejne poziomy zoptymalizowane pod kątem kosztów: najpierw rotowane proxy, a następnie pełna przeglądarka przez proxy. Ustaw `forceProxy: false`, a tania próba bezpośrednia i bezpośrednie renderowanie w przeglądarce zostaną wykonane przed nimi. Pierwszy szczebel, który zwróci odpowiedź pasującą do Twojego `validate`, wygrywa. Przy powtarzających się wywołaniach do tego samego hosta odtwarzana jest aktywna sesja, dzięki czemu drugie wywołanie jest tanie.

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

**Typowy czas odpowiedzi:** od 200 ms (warm) do ponad 30 s (cold solve na trudnej witrynie)
**Najlepsze do:** nowych celów, witryn o mieszanych zabezpieczeniach, scenariuszy "po prostu potrzebuję tej strony"

Bardziej szczegółowe omówienie zawiera [przewodnik po Smart Fetch](https://foura.ai/docs/guides/smart-fetch).

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

Najszybsza opcja. Wysyła request HTTP z realistyczną charakterystyką sieciową przeglądarki, bez uruchamiania procesu przeglądarki.

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

**Typowy czas odpowiedzi:** 200 ms do 2 s
**Najlepsze do:** API, serwisów informacyjnych, blogów, statycznych stron produktów

### Przeglądarka (`POST /api/browser/`)

Otwiera podany URL w instancji przeglądarki Chrome. Strona ładuje się całkowicie, kod JavaScript zostaje wykonany, a Ty otrzymujesz ostatecznie wyrenderowany 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"
  }'
```

**Typowy czas odpowiedzi:** od 2 s do 10 s
**Najlepsze do:** aplikacji SPA (Single-page apps), stron z leniwym ładowaniem (lazy loading), treści renderowanych w JavaScript

### Proxy (`POST /api/proxy/`)

Łączy żądania HTTP z automatyczną rotacją proxy. Jeśli pierwsza próba nie powiedzie się lub zostanie zablokowana, FourA ponawia próbę przez inne proxy.

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

**Typowy czas odpowiedzi:** od 1 s do 5 s
**Najlepsze do:** monitorowania cen w e-commerce, agregacji ofert turystycznych, witryn z detekcją botów

## Auto a tryb ręczny

Kiedy pozwolić trybowi auto decydować, a kiedy samodzielnie wywołać Single, Proxy lub Browser?

| Wybierz auto | Wybierz tryb ręczny |
|-----------|-------------|
| Nie wiesz jeszcze, czego wymaga witryna | Dokładnie wiesz, jakiego silnika wymaga cel |
| Chcesz jednego wywołania, które po prostu zadziała | Optymalizujesz strukturę żądania dla znanego celu |
| Akceptujesz ponowne wykorzystanie przez auto zapamiętanej sesji | Chcesz pełnej kontroli nad ponawianiem per-request, timeoutem i wyborem proxy |
| Akceptujesz kilka sekund testowania przy pierwszym wywołaniu | Opóźnienie pierwszego wywołania ma większe znaczenie niż autodetekcja |

Auto nie zawsze jest tańszym wyborem. Jeśli już wiesz, że cel działa z Single i włączonym `unblocker`, bezpośrednie wywołanie Single pomija drabinkę i kosztuje 2 kredyty. Auto na tym samym celu kosztuje tyle, ile zużyje jego drabinka.

## Kiedy łączyć różne podejścia

Niektóre procesy zyskują na użyciu wielu endpointów:

1. **Wykryj za pomocą auto**: przekaż regułę `validate` i pozwól drabince ustalić, jakiego szczebla wymaga witryna.
2. **Odtwórz za pomocą single**: pobierz `session.proxy`, `session.cookies` oraz `session.userAgent` zwrócone przez auto, a następnie wywołaj Single z tymi parametrami dla kolejnych stron na tym samym hoście.
3. **Przełącz na browser w razie problemów**: jeśli single zacznie zgłaszać błędy, przejdź na renderowanie w przeglądarce.
4. **Dodaj proxy**: jeśli otrzymujesz odmowę dostępu (403 lub stronę weryfikacji) bez auto, opakuj swoje żądanie w endpoint proxy, aby uzyskać automatyczną rotację.

To progresywne podejście utrzymuje niskie koszty przy zachowaniu wysokiej skuteczności.

## Wskazówki dotyczące wydajności

- Przekaż podciąg `validate.data.accept` na chronionych celach. Auto samo rozpoznaje popularne strony z wyzwaniami, ale tylko Twoja reguła może wychwycić nieznaną stronę weryfikacji lub stronę załadowaną bez potrzebnej zawartości.
- Domyślnie używaj endpointu single dla znanych, działających hostów i przechodź wyżej tylko wtedy, gdy to konieczne.
- Ustaw `checkText` w żądaniach przeglądarki, aby strona wyrenderowana bez Twojej zawartości zwracała błąd (`checkText:<text> not found`) zamiast sukcesu. `checkText` nie powoduje, że FourA czeka dłużej na tekst.
- Ustaw `maxTries` w żądaniach proxy, aby kontrolować zachowanie ponawiania prób (wartość domyślna to 5, maksymalna to 90).
- Utrzymuj rozsądną wartość `timeout_ms`: od 10 do 15 sekund dla większości stron, 30 s+ dla pierwszych wywołań auto na chronionych witrynach.

## Następne kroki

- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Szczegółowe omówienie `/api/auto/`
- [API Endpoints](https://foura.ai/docs/api/endpoints): Pełna dokumentacja parametrów
- [Scrape a Dynamic Website](https://foura.ai/docs/how-to/scrape-dynamic-website): Przewodnik krok po kroku po żądaniach przeglądarkowych
- [Quick Start](https://foura.ai/docs/getting-started/quick-start): Twoje pierwsze żądanie w 30 sekund
