Wybór odpowiedniego endpointu

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.

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.

Single (POST /api/single/)

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

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.

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.

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

Aktualizacja: 5 listopada 2026