Wybór odpowiedniego endpointu

FourA oferuje cztery endpointy zapytań, z których każdy jest zoptymalizowany pod kątem innego scenariusza. Wybór odpowiedniego oszczędza czas, zmniejsza koszty i poprawia wskaźniki sukcesu.

Szybki przewodnik decyzyjny

Użyj endpointu auto, gdy:

• Celujesz w nową stronę i nie wiesz jeszcze, czego ona wymaga
• Chcesz jednego wywołania, które obsługuje za Ciebie bezpośrednie zapytania, rotację proxy i mechanizmy awaryjne przeglądarki
• Chcesz sesji, którą możesz tanio powtórzyć przy następnym wywołaniu do tego samego hosta

Użyj endpointu single, gdy:

• Strona jest renderowana po stronie serwera (JavaScript nie jest wymagany)
• Potrzebujesz maksymalnej szybkości (zazwyczaj 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 polega na JavaScript do renderowania treści
• Treść ładuje się po początkowym wczytaniu strony
• Potrzebujesz w pełni wyrenderowanego DOM

Użyj endpointu proxy, gdy:

• Docelowa strona aktywnie blokuje zapytania
• Musisz rotować przez wiele adresów IP
• Poprzednie próby zwróciły błąd 403 lub strony z CAPTCHA

Porównanie endpointów

Auto (POST /api/auto/)

Endpoint smart-fetch. Przekazujesz URL i (najlepiej) regułę validate, a FourA przechodzi przez drabinę kosztów: tanie bezpośrednie sprawdzenie, rotowane proxy, pełna przeglądarka. Wygrywa pierwszy szczebel, który zwróci odpowiedź pasującą do Twojego validate. Przy powtarzających się wywołaniach do tego samego hosta odtwarzana jest ciepła 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: 200ms (ciepła sesja) do ponad 30s (zimne rozwiązywanie na trudnej stronie) Najlepsze do: Nowych celów, stron ze zróżnicowaną ochroną, sytuacji "chcę po prostu pobrać stronę"

Więcej szczegółów znajdziesz w przewodniku Smart Fetch.

Single (POST /api/single/)

Najszybsza opcja. Wysyła zapytanie HTTP z realistyczną charakterystyką sieciową zbliżoną do 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: 200ms do 2s Najlepsze do: API, stron informacyjnych, blogów, statycznych stron produktów

Browser (POST /api/browser/)

Otwiera Twój URL w instancji przeglądarki Chrome. Strona ładuje się całkowicie, wykonywany jest JavaScript i otrzymujesz końcowy, 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: 2s do 10s Najlepsze do: Aplikacji SPA (Single-page apps), stron z opóźnionym ładowaniem (lazy loading), treści renderowanych przez JavaScript

Proxy (POST /api/proxy/)

Łączy zapytania HTTP z automatyczną rotacją proxy. Jeśli pierwsza próba zakończy się niepowodzeniem lub zostanie zablokowana, FourA ponawia zapytanie 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: 1s do 5s Najlepsze do: Monitorowania cen e-commerce, agregatorów turystycznych, stron z detekcją botów

Auto kontra rozwiązania manualne

Kiedy powinieneś pozwolić na wybór przez auto, a kiedy samodzielnie wywołać Single, Proxy lub Browser?

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

Kiedy łączyć podejścia

Niektóre przepływy pracy zyskują na użyciu wielu endpointów:

1. Wykrywanie za pomocą auto: przekaż regułę validate i pozwól drabinie zorientować się, jakiego szczebla wymaga strona.
2. Odtwarzanie za pomocą single: weź session.proxy, session.cookies i session.userAgent zwrócone przez auto, a następnie wywołaj z nimi Single dla kolejnych stron na tym samym hoście.
3. Awaryjne przejście na browser: jeśli single zaczyna zawodzić, przełącz się na renderowanie w przeglądarce.
4. Dodanie proxy: jeśli jesteś blokowany (403 / CAPTCHA) bez użycia auto, opakuj swoje zapytanie w endpoint proxy dla automatycznej rotacji.

To stopniowe podejście utrzymuje niskie koszty przy zachowaniu wysokich wskaźników sukcesu.

Wskazówki dotyczące wydajności

• Przekaż podciąg validate.data.accept dla chronionych celów. Bez niego auto nie odróżni prawdziwej strony od strony z wyzwaniem zabezpieczającym.
• Używaj endpointu single jako domyślnego dla sprawdzonych hostów i przełączaj na wyższe poziomy tylko w razie potrzeby.
• Ustaw checkText w zapytaniach browser, aby uniknąć czekania na niepotrzebną treść.
• Ustaw maxTries w zapytaniach proxy, aby kontrolować zachowanie podczas ponowień (domyślnie 5, maksimum to 90).
• Utrzymuj rozsądną wartość timeout_ms: od 10 do 15 sekund dla większości stron, powyżej 30s dla zimnych wywołań auto przeciwko chronionym stronom.

Następne kroki

• Smart Fetch (Auto): Głębokie zanurzenie w /api/auto/
• API Endpoints: Pełna dokumentacja parametrów
• Scrape a Dynamic Website: Przewodnik krok po kroku po zapytaniach browser
• Quick Start: Twoje pierwsze zapytanie w 30 sekund