Tworzenie zadania

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

Krok 1: Otwórz Dashboard

Przejdź do Dashboardu 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 klucz w postaci jawnej z przyciskiem kopiowania, a w sekcji Test your first request gotowe do uruchomienia polecenie curl z opcją Copy command. Na telefonie lub tablecie opcja Try it in the Playground przeniesie Cię bezpośrednio do narzędzia Playground.

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: Zarządzanie kluczami API.

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/)

Inteligentna opcja domyślna. Przekaż URL oraz regułę validate, a FourA wybierze najtańszą działającą ścieżkę: bezpośredni request, rotujące proxy lub pełną przeglądarkę. Najlepsze rozwiązanie, gdy celujesz w nową stronę i nie wiesz jeszcze, czego ona wymaga.

Single (POST /api/single/)

Wysyła szybki request HTTP. Najlepsze dla statycznych stron HTML i endpointów API. Czas odpowiedzi: zazwyczaj poniżej 2 sekund.

Browser (POST /api/browser/)

Uruchamia instancję przeglądarki Chrome do renderowania JavaScriptu. Najlepsze dla aplikacji SPA, leniwie ładowanych treści i stron wymagających wykonania JS. Czas odpowiedzi: od 2 do 10 sekund.

Proxy (POST /api/proxy/)

Kieruje request przez rotujące proxy z automatycznymi ponowieniami. Najlepsze dla witryn, które weryfikują klienta lub zwracają różne odpowiedzi w zależności od kraju.

Krok 4: Wyślij swój pierwszy request

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: Odczytaj response

{
  "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 to tablica obiektów, po jednym dla każdego przeskoku przekierowania. Każdy wpis zawiera result z linią statusu oraz wszystkimi nagłówkami odpowiedzi zwróconymi przez cel.

Kluczowe pola:

• status: kod statusu HTTP ze strony docelowej
• data: treść odpowiedzi (HTML, JSON lub czysty tekst)
• total_time: czas trwania requestu w sekundach

Krok 6: Wypróbuj request przeglądarkowy

Jeśli strona docelowa używa JavaScriptu do renderowania treści, użyj endpointu przeglądarki:

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

Następne kroki

• Dashboard Overview: Pełny przewodnik po panelu
• Playground: Testuj żądania w panelu przed napisaniem kodu
• Smart Fetch (Auto): Szczegółowe omówienie endpointu auto
• Choosing the Right Endpoint: Szczegółowe porównanie
• Common Issues: Szybkie rozwiązywanie problemów