Tworzenie zadania

Ten przewodnik przeprowadzi Cię przez proces tworzenia klucza API i wysyłania pierwszego żądania za pomocą FourA Dashboard.

Krok 1: Otwórz Dashboard

Przejdź do Dashboard i zaloguj się na swoje konto FourA.

Krok 2: Utwórz klucz API

Przejdź do strony API Keys i kliknij Create API key. Gdy masz już klucz, przycisk nad listą ma etykietę Create Key.

Nadaj kluczowi opisową nazwę (np. "production-scraper" lub "dev-testing"). Okno dialogowe API Key Created wyświetla jawny klucz wraz z przyciskiem kopiowania, a w sekcji Test your first request gotowe do uruchomienia polecenie curl z przyciskiem Copy command. Na telefonie lub tablecie opcja Try it in the Playground przeniesie Cię bezpośrednio na tę stronę.

Jeśli to pominiesz, kliknij później ikonę oka w wierszu klucza, aby wyświetlić go ponownie. Starsze klucze, utworzone przed wprowadzeniem funkcji podglądu, nie mogą zostać przywrócone; wygeneruj je ponownie, aby przejść na nowy system. Pełny opis procedury: Managing API Keys.

Twój klucz wygląda następująco: pk_live_a1b2c3d4e5f6...

Krok 3: Wybierz endpoint

FourA oferuje cztery endpointy dla różnych scenariuszy:

Auto (POST /api/auto/)

Inteligentny wybór domyślny. Przekaż URL, najlepiej z regułą validate, a FourA przechodzi po kolei od rotującego proxy do pełnej przeglądarki przez proxy, zatrzymując się na pierwszej odpowiedzi spełniającej warunki. Ustaw forceProxy: false, aby najpierw spróbować żądania bezpośredniego. Najlepsze rozwiązanie, gdy pracujesz z nową witryną i jeszcze nie wiesz, czego wymaga.

Single (POST /api/single/)

Wysyła szybkie żądanie HTTP. Najlepsze dla statycznych stron HTML oraz endpointów API. Czas odpowiedzi: zazwyczaj poniżej 2 sekund.

Browser (POST /api/browser/)

Uruchamia instancję przeglądarki Chrome, aby renderować JavaScript. Najlepsze dla aplikacji SPA, leniwie ładowanej zawartości i stron wymagających wykonania kodu JS. Czas odpowiedzi: od 2 do 10 sekund.

Proxy (POST /api/proxy/)

Kieruje żądanie przez rotujące serwery proxy z automatycznym ponawianiem. Najlepsze dla stron, które weryfikują źródło zapytań lub zwracają różne odpowiedzi w zależności od kraju.

Krok 4: Wyślij swoje pierwsze żądanie

Otwórz terminal i uruchom:

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

Krok 5: Odczytanie odpowiedzi

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<html>...</html>",
  "total_time": 0.45
}

Pole headers jest tablica obiektow, po jednym dla kazdego przeskoku przekierowania (hop). Kazdy wpis zawiera result z linia statusu oraz wszystkimi naglowkami response zwroconymi przez cel.

Kluczowe pola:

  • status: kod statusu HTTP ze strony docelowej
  • data: tresc response (HTML, JSON lub zwykly tekst)
  • total_time: czas trwania request w sekundach

Krok 6: Wyprobuj request przez przegladarke

Jesli strona docelowa uzywa JavaScriptu do renderowania tresci, uzyj zamiast tego endpointu przegladarki:

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/products", "timeout_ms": 15000}'

Odpowiedź przeglądarki używa body zamiast data:

{
  "status": 200,
  "headers": {"content-type": "text/html"},
  "body": "<html>...</html>"
}

Typowe problemy

Problem Rozwiązanie
Nie wiesz, którego silnika użyć Zacznij od endpointu auto. Wybiera właściwą ścieżkę i zapamiętuje, co zadziałało.
Pusta treść Przełącz się z endpointu single na browser: strona prawdopodobnie wymaga renderowania JS
Strona weryfikacji w odpowiedzi Przełącz się na endpoint proxy, aby korzystać z automatycznej rotacji IP
Przekroczenie limitu czasu (timeout) Zwiększ timeout_ms lub sprawdź, czy URL jest poprawny
Zgubiony klucz Kliknij ikonę oka w wierszu klucza w sekcji API Keys, aby go odkryć, lub wygeneruj nowy, jeśli to klucz starszego typu

Kolejne kroki

Aktualizacja: 28 października 2026