Dokumentacja › Dashboard › Tworzenie zadania

Tworzenie zadania

Ten przewodnik opisuje, jak utworzyć klucz API i wysłać pierwsze żądanie, korzystając z 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 Key.

Nadaj kluczowi opisową nazwę (np. "production-scraper" lub "dev-testing"). Okno dialogowe potwierdzenia wyświetli jawny klucz wraz z przyciskiem kopiowania.

Jeśli go przegapisz, kliknij później ikonę oka w wierszu klucza, aby wyświetlić go ponownie. Starsze klucze, które zostały utworzone przed wprowadzeniem tej funkcji, nie mogą zostać przywrócone; wygeneruj je ponownie, aby móc z niej korzystać. Pełny proces: Managing API Keys.

Twój klucz wygląda tak: pk_live_a1b2c3d4e5f6...

Krok 3: Wybierz endpoint

FourA oferuje cztery endpointy do 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średnie żądanie, obracający się proxy lub pełną przeglądarkę. Najlepsze, gdy wybierasz za cel nową stronę i jeszcze nie wiesz, czego potrzebuje.

Single (POST /api/single/)

Wysyła szybkie żądanie 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 w celu renderowania JavaScript. Najlepsze dla aplikacji SPA, leniwie ładowanej treści (lazy loading) i stron wymagających wykonania JS. Czas odpowiedzi: od 2 do 10 sekund.

Proxy (POST /api/proxy/)

Kieruje żądanie przez obracające się proxy z automatycznymi ponowieniami. Najlepsze dla stron z wykrywaniem botów lub treści ograniczonych geograficznie.

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: Odczytaj odpowiedź

{
  "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 przekierowania. Każdy wpis zawiera result z linią statusu oraz wszystkimi nagłówkami odpowiedzi, które zwrócił cel.

Kluczowe pola:

  • status: kod statusu HTTP ze strony docelowej
  • data: ciało odpowiedzi (HTML, JSON lub czysty tekst)
  • total_time: czas trwania żądania w sekundach

Krok 6: Wypróbuj żądanie z przeglądarki

Jeśli strona docelowa używa JavaScript do renderowania treści, użyj zamiast tego 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>"
}

Częste problemy

Problem Rozwiązanie
Nie wiesz, którego silnika użyć Zacznij od endpointu auto. Wybiera odpowiednią ścieżkę i zapamiętuje, co zadziałało.
Pusta treść Przełącz się z endpointu single na browser: strona prawdopodobnie wymaga renderowania JS.
Captcha w odpowiedzi Przełącz się na endpoint proxy, aby włączyć automatyczną rotację IP.
Timeout Zwiększ timeout_ms lub sprawdź, czy URL jest poprawny.
Utrata klucza Kliknij ikonę oka w wierszu klucza w API Keys, aby go wyświetlić, lub wygeneruj ponownie w przypadku starego klucza.

Następne kroki

Aktualizacja: 8 lipca 2026
← Przegląd panelu Zarządzanie kluczami API →